...
The live website is whatever is committed to asf-site, here: https://gitbox.apache.org/repos/asf?p=zookeeper.git;a=shortlog;h=refs/heads/asf-site . Any changed committed to this branch are immediately replicated to the live production website at http://zookeeper.apache.org/
...
Steps to update the site:
1. git clone -b website https://gitbox.apache.org/repos/asf/zookeeper.git
2. update the appropriate pages, typically a markdown file e.g. credits.md, etc...
3. mvn clean install
4. cp -RP _released_docs target/html/doc These are the static release docs, not generated in this process.
At this point verify that the generated files render properly (open target/html/index.html in a browser). If you are happy with the results move on to the next step, otherwise go to step 2 above.
5. git status should show modified files for the markdown that you changed
6. git add <the changed files>
7. git commit -m "<appropriate commit message>"
8. git push origin website
The source for the site is committed, now we need to push the generated files to the live site.
9. git checkout asf-site
10. rm -fr content
11. mv target/html content
12. git add content
Verify that content/index.html and other generated files are proper, e.g. open them in a browser
13. git status should show modified files for the markdown that you changed
14. git commit -m "<appropriate commit message>"
15. git push origin asf-site