From: Zac Dover Date: Mon, 2 Jun 2025 02:32:36 +0000 (+1000) Subject: doc/start: edit documenting-ceph.rst X-Git-Tag: v19.2.3~64^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F63652%2Fhead;p=ceph.git doc/start: edit documenting-ceph.rst Edit the section "Build the Source" in doc/start/documenting-ceph.rst. Also correct a misuse of the word "presently", which means "in a little while", not "now". Signed-off-by: Zac Dover (cherry picked from commit dd66c9e68b3518058382454949021504c65efe4b) --- diff --git a/doc/start/documenting-ceph.rst b/doc/start/documenting-ceph.rst index 82ccb1503bacb..b411c8e12753a 100644 --- a/doc/start/documenting-ceph.rst +++ b/doc/start/documenting-ceph.rst @@ -253,31 +253,31 @@ To scan for the reachability of external links, execute: admin/build-doc linkcheck -Executing ``admin/build-doc`` will create a ``build-doc`` directory under +Running ``admin/build-doc`` creates a ``build-doc`` directory under ``ceph``. You may need to create a directory under ``ceph/build-doc`` for -output of Javadoc files: +Javadoc file output: .. prompt:: bash $ mkdir -p output/html/api/libcephfs-java/javadoc -The build script ``build-doc`` will produce an output of errors and warnings. -You MUST fix errors in documents you modified before committing a change, and -you SHOULD fix warnings that are related to syntax you modified. +The build script ``build-doc`` produces output partially consisting of errors +and warnings. You MUST fix errors in documents you modified before committing +a change, and you SHOULD fix warnings that are related to syntax you modified. .. important:: You must validate ALL HYPERLINKS. If a hyperlink is broken, it automatically breaks the build! -Once you build the documentation set, you may start an HTTP server at -``http://localhost:8080/`` to view it: +After you have built the documentation set, you may start an HTTP server at +``http://localhost:8080/`` to view it by running the following command: .. prompt:: bash $ admin/serve-doc You can also navigate to ``build-doc/output`` to inspect the built documents. -There should be an ``html`` directory and a ``man`` directory containing -documentation in HTML and manpage formats respectively. +Within ``build-doc/output`` is an ``html`` directory and a ``man`` directory +containing documentation in HTML and manpage formats respectively. Build the Source (First Time) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~