Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
  • Sign in
  • Git Beginners Git Beginners
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Issues 1
    • Issues 1
    • List
    • Boards
    • Service Desk
    • Milestones
    • Iterations
    • Requirements
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • Insights
    • Issue
  • Wiki
    • Wiki
  • Activity
  • Create a new issue
  • Issue Boards
Collapse sidebar
  • Computer-ScienceComputer-Science
  • Git BeginnersGit Beginners
  • Issues
  • #1
Closed
Open
Issue created Jul 23, 2018 by whkbester@whkbesterGuest

Documentation style

Some general thoughts:

  1. Under “Setup”, there should be a note to say that without the --global flag, the settings will apply to the current repository.
  2. For the description of git pull, should it not be “fetch the latest commits”?
  3. As part of the “Note” about backups for first-time users, I also strongly urge you to write something about the university’s plagiarism policy. This is to say, using Git is not an excuse to host university work in the open on GitHub or Bitbucket. My CS244 plagiarism policy forbids this.

I have a couple of suggestions re writing style:

  1. Write “directory” instead of “folder”; it is the Unix command line after all.
  2. Do not leave out verbs; for example, write, “Local changes are destroyed”.
  3. I really hate reading “in order to” when a simple “to” will do.
  4. Refer to Git as “Git”, and not git.
  5. Especially for beginners, perhaps rather write out “repo” as “repository” at its very first use.
  6. Do not capitalise “Index”.
  7. “Setup” is a noun; use “set up” for the verb. “Login” and “log in” is used similarly.
  8. You should not switch between the second-person imperative and the third-person declarative; choose one and stick to it.
  9. If you are going to set “HEAD” as HEAD, do it consistently.
  10. I think it is “applicable to”.
  11. You have dropped articles here and there.
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information
Assignee
Assign to
Time tracking