Create a gist now

Instantly share code, notes, and snippets.

Document Structure Refactoring

Document Structure Refactoring

Pattern 1: Prefer headings rather than list items.

Prior Structure

Use the list items.

* foo
  * foofoo
* bar
  * barfoo
  * barbar
* baz
  * bazfoo

New Structure

Use the headings.

# Prefer headings rather than list items

The lead sentence.

## foo


## bar

* barfoo
* barbar

## baz

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment