Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add commas before "but" throughout documentation #9582

Merged
merged 11 commits into from
Aug 16, 2024

Conversation

russellsanborn
Copy link
Contributor

In a few files opened, there were some blank strings at the end of lines that were auto cleaned up. I can remove these updates if you prefer them to stay.

@clayjohn
Copy link
Member

clayjohn commented Jul 9, 2024

Looking through this, I am seeing a lot of cases that add a comma where it shouldn't. The general rule for english grammar is that you place a comma before "but" when it is being used to connect two independent clauses. When the "but" is not being used to connect two independent clauses, a comma should not be used

Copy link
Member

@AThousandShips AThousandShips left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some cases that I feel are either outright wrong or at minimum hurt the flow of the sentence, probably more amongst these but these are the to me clear ones

about/faq.rst Outdated Show resolved Hide resolved
tutorials/2d/custom_drawing_in_2d.rst Outdated Show resolved Hide resolved
getting_started/first_3d_game/03.player_movement_code.rst Outdated Show resolved Hide resolved
contributing/documentation/docs_writing_guidelines.rst Outdated Show resolved Hide resolved
contributing/documentation/docs_image_guidelines.rst Outdated Show resolved Hide resolved
contributing/development/core_and_modules/object_class.rst Outdated Show resolved Hide resolved
russellsanborn and others added 7 commits July 9, 2024 13:55
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
…stem.rst

Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
@russellsanborn
Copy link
Contributor Author

russellsanborn commented Jul 9, 2024

Definitely good call out @AThousandShips and @clayjohn . I got a little comma happy. I found a few others and had a question on one of them as i try to align. Let me know if you see anything else or if you want me to just close the PR.

@AThousandShips
Copy link
Member

I'll take a look tomorrow!

Copy link
Member

@Calinou Calinou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Aside of my review comments, all other changes look good to me.

Copy link
Member

@AThousandShips AThousandShips left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Save for the cases suggested this looks good now

@skyace65 skyace65 merged commit b54f912 into godotengine:master Aug 16, 2024
1 check passed
@skyace65
Copy link
Contributor

Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants