[Docs] Apply Google style guide to development.rst

[andrew-anyscale]

Apply Google developer documentation style guide rules to development.rst:

• Sentence case: fix 11 headings (Source, Steps, Only, Full Source Build, MacOS, Development Tooling, Pre-commit Hooks, Advanced Build Options, Fast/Debug/Optimized Builds, Building the Docs)
• Second person: replace "We provide" with "Use the script"
• Present tense: replace future "will" constructions throughout (env var list, prose sections)
• Contractions: "Do not" -> "Don't", "will not" -> "won't", "pip is not" -> "isn't"
• Active voice: env var list passive constructions converted ("will be built" -> "Ray builds", etc.)
• macOS branding: fix "MacOS" -> "macOS" and "mac" -> "Mac" throughout

Topic: style-wheel-docs
Relative: add-refs
Signed-off-by: andrew andrew@anyscale.com

[andrew-anyscale]

Reviews in this chain:
└#61501 [Docs] Add path-chooser, fix cross-references, and reorganize tips
　└#61502 [Docs] Apply Google style guide to development.rst
　　└#61503 [Docs] Reduce callout noise in development.rst
　　　└#61504 [Docs] Add distributable manylinux wheel build path to development.rst

[andrew-anyscale]

#	head	base	diff	date	summary
0	c804c62a	7a39e957	diff	Mar 4 15:00 PM	1 file changed, 58 insertions(+), 59 deletions(-)
1	1287b638	2b82c0b0	diff	Mar 4 15:03 PM	1 file changed, 1 insertion(+), 1 deletion(-)
2	2a080c4f	9e5f42c8	diff	Mar 4 15:08 PM	1 file changed, 1 insertion(+), 3 deletions(-)
3	3a1a26e8	7a51cf6e	diff	Mar 4 15:19 PM	1 file changed, 3 insertions(+), 1 deletion(-)
4	404f3511	7a51cf6e	diff	Mar 5 9:31 AM	1 file changed, 1 insertion(+), 1 deletion(-)
5	9f135ad6	7a51cf6e	diff	Mar 5 9:34 AM	1 file changed, 1 insertion(+), 1 deletion(-)
6	28443475	7a51cf6e	diff	Mar 5 17:00 PM	1 file changed, 6 insertions(+), 8 deletions(-)
7	4a981403	87b91a3d	rebase	Mar 5 21:20 PM	0 files changed

[gemini-code-assist]

Code Review

This pull request applies the Google developer documentation style guide to development.rst, improving readability and consistency. The changes include using sentence case for headings, adopting the second person and active voice, using present tense and contractions, and correcting macOS branding. The modifications are well-executed and significantly enhance the quality of the documentation. I have one minor suggestion to further improve consistency in the description of environment variables.

[ronny-anyscale]

lgtm

[dstrodtman]

Let's aim for sentence case for all headers, including H1s. Agree we're definitely not there today.

[ronny-anyscale]

Suggested change

4. Replace Python files in the installed package with your local editable copy. Use the script ``python python/ray/setup-dev.py`` to do this. The script removes the ``ray/tune``, ``ray/rllib``, ``ray/autoscaler`` dir (among other directories) bundled with the ``ray`` pip package, and replaces them with links to your local code. This way, changing files in your git clone directly affects the behavior of your installed Ray.

4. Replace Python files in the installed package with your local editable copy. Use the script ``python python/ray/setup-dev.py`` to do this. The script removes the ``ray/tune``, ``ray/rllib``, ``ray/autoscaler`` directories (among others) bundled with the ``ray`` pip package, replacing them with links to your local code. This way, changing files in your git clone directly affects the behavior of your installed Ray.

[andrew-anyscale]

Solid! Pushing update for this

[dstrodtman]

Let's aim for sentence case for all headers, including H1s. Agree we're definitely not there today.