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
Fix typos and improve the documentation #19763
Conversation
@jonatack we don't consider test names documentation. Could you remove the |
f5e1ee7
to
aa5bea2
Compare
@senny thanks for reviewing! Updated. |
@jonatack one more thing, we try to hard wrap our guides at around 80 chars. As we are not going to change them all at once it would be nice if you can wrap the paragraphs that have changes anyway. This way we are not messing up the git history and migrate the guides slowly towards our goal. |
@jonatack I think so, you can render the guides locally to verify. |
dfe8fbe
to
f4414f5
Compare
You're right, rendering the guide locally with the TIP section line-wrapped looked the same. The generated HTML:
Updated and squashed. |
This is a squash of the following commits, from first to last: - Fix minor, random things I’ve come across lately that individually did not seem worth making a PR for, so I saved them for one commit. One common error is using “it’s” (which is an abbreviation of “it is”) when the possessive “its” should be used for indicating possession. - Changes include the name of a test, so remove the `[skip ci]` (thanks @senny). - Line wrap the changes at 80 chars and add one more doc fix. - Add a missing line wrap in the Contributing to Ruby on Rails Guide. - Line wrap the `TIP` section in the Contributing to Ruby on Rails Guide as well. Rendering the guide locally with `bundle exec rake guides:generate` did not show any change in on-screen formatting after adding the line wrap. The HTML generated is (extra line added to illustrate where the line wrap takes place): <div class="info"><p>Please squash your commits into a single commit when appropriate. This simplifies future cherry picks and also keeps the git log clean.</p></div> - Squash commits.
5df0082
to
6345f31
Compare
Fix typos and improve the documentation
@jonatack great work! 💛 |
Mostly minor, random things I’ve come across lately that individually
did not seem worth making a PR for, so I saved them up for one commit.
One common error is using “it’s” (which is an abbreviation of “it is”)
when the possessive “its” should be used for indicating possession.