Update doc build and project site sections of release documentation
Add section headers for the documentation build and project site
update sections.
Reword the documentation build section to make a bit more sense. The
command to build the documentation should be mentioned before the bit
about how to upload it.
Change-Id: Ica473dda5e74726a297918a002de1a62ae8de0d1
diff --git a/Documentation/dev-release.txt b/Documentation/dev-release.txt
index b78ee13..5392114 100644
--- a/Documentation/dev-release.txt
+++ b/Documentation/dev-release.txt
@@ -325,29 +325,34 @@
[[upload-documentation]]
==== Upload the Documentation
-Build the release notes:
-
+* Build the release notes:
++
----
make -C ReleaseNotes
----
+* Build the documentation:
++
+----
+ buck build docs
+----
+
+* Extract the documentation html files from the generated zip file
+`buck-out/gen/Documentation/searchfree.zip`.
+
* Upload the html files manually via web browser to the
link:https://console.developers.google.com/project/164060093628/storage/gerrit-documentation/[
gerrit-documentation] storage bucket. The `gerrit-documentation`
storage bucket is accessible via the
link:https://cloud.google.com/console[Google Developers Console].
-** Documentation html files must be extracted from
-`buck-out/gen/Documentation/searchfree.zip` after generating with:
-----
- buck build docs
-----
+[[update-links]]
+==== Update Google Code project links
-* Update Google Code project links
-** Go to http://code.google.com/p/gerrit/admin
-** Update the documentation link in the `Resources` section of the
+* Go to http://code.google.com/p/gerrit/admin
+* Update the documentation link in the `Resources` section of the
Description text, and in the `Links` section.
-** Add a link to the new release notes in the `News` section of the
+* Add a link to the new release notes in the `News` section of the
Description text
[[update-issues]]
