bpo-45677: Reword first section of sqlite3 docs#29326
Conversation
|
It would be nice to have a native english speaker verify these changes. |
Co-authored-by: Jacob Walls <[email protected]>
AlexWaygood
left a comment
There was a problem hiding this comment.
This looks like a solid improvement, but here are a few thoughts. (I'm not a sqlite expert by any means, but I am a native English speaker, and have a masters in journalism :)
Co-authored-by: Alex Waygood <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
|
FYI, @AlexWaygood and @jacobtylerwalls. See also the topic Using personal or passive tone in the docs on Discourse. |
sqlite3 docs
|
Thanks @erlend-aasland for the PR, and @willingc for merging it 🌮🎉.. I'm working now to backport this PR to: 3.9, 3.10. |
|
@willingc: Please replace |
* bpo-45677: Avoid addressing the reader as 'you' in sqlite3 docs * Adjust wording * Adjust wording again * Typo * Update Doc/library/sqlite3.rst Co-authored-by: Jacob Walls <[email protected]> * Address review: adjust wording * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Apply Alex' suggestion, and apply 80 char limit to PR * Minor adjustment Co-authored-by: Jacob Walls <[email protected]> Co-authored-by: Alex Waygood <[email protected]> (cherry picked from commit 6c5a312) Co-authored-by: Erlend Egeberg Aasland <[email protected]>
|
GH-29566 is a backport of this pull request to the 3.10 branch. |
|
GH-29567 is a backport of this pull request to the 3.9 branch. |
* bpo-45677: Avoid addressing the reader as 'you' in sqlite3 docs * Adjust wording * Adjust wording again * Typo * Update Doc/library/sqlite3.rst Co-authored-by: Jacob Walls <[email protected]> * Address review: adjust wording * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Apply Alex' suggestion, and apply 80 char limit to PR * Minor adjustment Co-authored-by: Jacob Walls <[email protected]> Co-authored-by: Alex Waygood <[email protected]> (cherry picked from commit 6c5a312) Co-authored-by: Erlend Egeberg Aasland <[email protected]>
|
Thanks, Carol! |
* bpo-45677: Avoid addressing the reader as 'you' in sqlite3 docs * Adjust wording * Adjust wording again * Typo * Update Doc/library/sqlite3.rst Co-authored-by: Jacob Walls <[email protected]> * Address review: adjust wording * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Apply Alex' suggestion, and apply 80 char limit to PR * Minor adjustment Co-authored-by: Jacob Walls <[email protected]> Co-authored-by: Alex Waygood <[email protected]> (cherry picked from commit 6c5a312) Co-authored-by: Erlend Egeberg Aasland <[email protected]> Co-authored-by: Erlend Egeberg Aasland <[email protected]>
* bpo-45677: Avoid addressing the reader as 'you' in sqlite3 docs * Adjust wording * Adjust wording again * Typo * Update Doc/library/sqlite3.rst Co-authored-by: Jacob Walls <[email protected]> * Address review: adjust wording * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Apply Alex' suggestion, and apply 80 char limit to PR * Minor adjustment Co-authored-by: Jacob Walls <[email protected]> Co-authored-by: Alex Waygood <[email protected]> (cherry picked from commit 6c5a312) Co-authored-by: Erlend Egeberg Aasland <[email protected]> Co-authored-by: Erlend Egeberg Aasland <[email protected]>
* bpo-45677: Avoid addressing the reader as 'you' in sqlite3 docs * Adjust wording * Adjust wording again * Typo * Update Doc/library/sqlite3.rst Co-authored-by: Jacob Walls <[email protected]> * Address review: adjust wording * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Update Lib/sqlite3/__init__.py Co-authored-by: Alex Waygood <[email protected]> * Update Doc/library/sqlite3.rst Co-authored-by: Alex Waygood <[email protected]> * Apply Alex' suggestion, and apply 80 char limit to PR * Minor adjustment Co-authored-by: Jacob Walls <[email protected]> Co-authored-by: Alex Waygood <[email protected]>
https://bugs.python.org/issue45677