Staging selected lines. Issue #57

PR for issue #57 Staging selected lines.

Do you think this covers everything adequately?
Let me know if there's any typos or re-wording you'd prefer or whatever.

I haven't had a chance to add images about staging selected lines. Do you think they would help, or do you think they would cause clutter? As for myself, when I originally found this functionality in Git Extensions I found it quite straightforward to use, so perhaps the instructions are sufficient without additional images. 

I use this feature regularly in my work. I need to find out what I do and raise a gitextensions issue because there's a way to crash Git Extensions - I think by resetting individual lines on a staged file.


Hi guys, I'm pleased you like the changes and pleased to help document such a great tool.

I wrote "the commit" instead of "a commit" because making a commit is a two step process of staging, then making the actual commit. The wording is intended to let the reader know that now we are making "the" commit that the reader has been preparing while reading the information about staging, and all of this under the "Commit changes" title. I wanted to differentiate the final act from the concept of a commit as a thing.

I did not add "the" to "Staging Changes" and "Staging Selected Lines" because the titles are neater and there is not the confusion between "a whole commit" and "the final action of committing". I think the two titles would otherwise have to be "Staging the changes" and "Staging the changes in only selected lines". "Staging the selected lines" is in some way wrong - but perhaps only someone that studies English could explain properly.

"Staging Changes", "Staging Selected Lines" and "Undoing or Resetting Changes" are actually the inconsistently capitalised lines. The rest of the help documentation does not capitalise sub-headings.

In hindsight, better titles would probably be:

    Making a commit
    Staging changes
    Staging selected lines
    Undoing or resetting changes
    Committing the changes I think the first title clarifies that "a commit" is a thing, by using a noun. The last title clarifies the final act of "committing" by using a verb. I do note that I've added "the" to only the last title. :) It reads better to me but I can't really explain why.

I would like to add another commit to the page. I think I should change the titles to those above if you approve. I would also like to fix the capitalisation. There is a spelling mistake ("stanging"). I would like to specifically add a line stating that making a commit is a two-step process of staging and committing.

Do I simply add a commit on the same branch for you to merge into latest?