What are good guidelines for formatting answers and posts on Sage?

Here are some recommended guidelines for formatting content on Sage:

Correct spelling, punctuation, and grammar make content on Sage better and easier to read.

  • If an answer includes incorrect spelling or grammar mistakes, other users can Suggest Edits to correct it.
  • The answering user should accept these suggestions.

Same with correct spacing and bulleting.

  • Please include spaces between sentences — the norm is one, but two is fine.
  • Please do not include spaces right before punctuation marks. Also, it’s better if sentences end with one punctuation mark.
  • Please include one full space between paragraphs — even if the paragraph is only one sentence or a sentence fragment.
  • Whenever possible, please use Sage’s number and bullet list buttons to create lists, rather than using your own customized list style:
Screen_Shot_2018-03-27_at_5.09.03_PM.png

Boldface, heading, and italics formatting should be used thoughtfully.

  • It’s better if these formatting styles aren’t over-used.
  • For example, an answer shouldn’t be all bold, or mostly bold. Or all italics, or mostly italics.

Wikipedia’s formatting rules are a good baseline.

Good capitalization is also useful.

Correct capitalization should be used in questions and answers:

  • Proper nouns should be capitalized.
  • So should the singular pronoun “I.”
  • Also acronyms: NATO, FAQ, HTML.
  • Only proper nouns should be capitalized. Users should not use capitalization to emphasize a concept or phrase (e.g., “Social Media”).
  • Capitalization should not be used for emphasis; boldface should be used instead.

Use of LaTeX to perform formatting beyond what is provided directly in the editor is not allowed and will be considered bad formatting. This includes the use of alternate fonts, font sizes, font colors.

Leave a Comment

Your email address will not be published. Required fields are marked *