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

Fix typos and improve the documentation #19763

Merged
merged 1 commit into from Apr 15, 2015
Merged

Conversation

jonatack
Copy link
Contributor

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.

@senny
Copy link
Member

senny commented Apr 15, 2015

@jonatack we don't consider test names documentation. Could you remove the [ci skip]?

@jonatack
Copy link
Contributor Author

@senny thanks for reviewing! Updated.

@senny
Copy link
Member

senny commented Apr 15, 2015

@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.

@senny
Copy link
Member

senny commented Apr 15, 2015

@jonatack I think so, you can render the guides locally to verify.

@jonatack
Copy link
Contributor Author

You're right, rendering the guide locally with the TIP section line-wrapped looked the same. The generated HTML:

<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>

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.
@jonatack jonatack changed the title Fix typos in the documentation [ci skip] Fix typos and improve the documentation Apr 15, 2015
senny added a commit that referenced this pull request Apr 15, 2015
Fix typos and improve the documentation
@senny senny merged commit c0939a5 into rails:master Apr 15, 2015
@senny
Copy link
Member

senny commented Apr 15, 2015

@jonatack great work! 💛

@jonatack jonatack deleted the fix-typos-in-docs branch April 15, 2015 11:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants