HomeFreeBSD

Pass the committer's guide through igor.

Description

Pass the committer's guide through igor.

Most of those were fixed.

  • "(s)" used 5 times Please do not form plurals this way. It is a holdover from lazy programming practices, is difficult to read, and almost always unnecessary. A plural formed with a plain "s" is usually correct when speaking about numbers of one or more.
  • "in order to" used 6 times Unless "in order to" has some special meaning here, "to" is simpler.
  • "i.e." used 1 time "I.e." (Latin "id est") means "that is" and is mostly used in academic and scientific writing. Consider replacing with the more common English words. Both forms are usually followed by a comma for a verbal pause: "i.e., a b c" or "that is, a b c"
  • "e.g." used 1 time "E.g." (Latin "exempli gratia") means "for example" and is mostly used in academic and scientific writing. Consider replacing with the more common English words. Both forms are usually followed by a comma for a verbal pause: "e.g., a b c" or "for example, a b c"
  • "simply" used 3 times Use "simply" to mean "in a simple manner", "just", or "merely", not the patronizing "details omitted because they are not simple enough for you". "basically" used 2 times Use "basically" to mean "essentially" or "fundamentally", not "only the basics are shown because anything more will be too complicated for you".
  • "the following" used 18 times "as follows" used 3 times If something is following, the reader can see it without being told.
  • "should" used 83 times Use "should" sparingly, it is feeble and suggests unsureness. Attempt to be imperative: "do this" rather than "you should do this".
  • "you" used 176 times "your" used 84 times "You" and "your" are informal and subjective. Attempt to be formal and objective: "the file" rather than "your file".

Reviewed by: wblock
Sponsored by: Absolight
Differential Revision: https://reviews.freebsd.org/D7531

Details

Provenance
matAuthored on
Reviewer
wblock
Differential Revision
D7531: Igor the shit out of the committer's guide.
Parents
rD50298: Add Alexander Moisseev to contributors for sysutils/backuppc4
Branches
Unknown
Tags
Unknown