[docs] clarify FAST build option, fixes ray-project#35293 (ray-projec…

…t#35297)

nit changes (sub-project --> subproject)

Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: e428265 <[email protected]>

doc/README.md

@@ -21,17 +21,20 @@ make develop && open _build/html/index.html
 
 > **_NOTE:_**  The above command is for development. To reproduce build failures from the
 > CI, you should use `make html` which is the same as `make develop` but treats warnings as errors.
+> Additionally, note that `make develop` uses the `FAST` environment variable to skip some
+> expensive parts of the build process. In particular, it will aggressively prune the
+> left-hand side navigation, but leave the documents itself intact.
 
-## Building just one sub-project
+## Building just one subproject
 
-Often your changes in documentation just concern one sub-project, such as Tune or Train.
-To build just this one sub-project, and ignore the rest
+Often your changes in documentation just concern one subproject, such as Tune or Train.
+To build just this one subproject, and ignore the rest
 (leading to build warnings due to broken references etc.), run the following command:
 
 ```shell
 DOC_LIB=<project> sphinx-build -b html -d _build/doctrees  source _build/html
 ```
-where `<project>` is the name of the sub-project and can be any of the docs projects in the `source/`
+where `<project>` is the name of the subproject and can be any of the docs projects in the `source/`
 directory either called `tune`, `rllib`, `train`, `cluster`, `serve`, `data` or the ones starting
 with `ray-`, e.g. `ray-observability`.