Keeping it Light: Writing in Markdown and reStructuredText

What do you mean, "light"?

I'm using the term light with regard to the formatting of text documents, especially because I prefer to treat Documentation as Code.

Benefits of Light vs Heavy Markup

  • Easy to see errors

  • Writing is natural

  • Can view source and understand topics, see structure visually.

  • Great for contributions!

  • No need to learn a lot of arcane syntax. Rules are intuitive.