Links and references

Last updated

What happens to each kind of link on the public site. Pages of the site stay links; anything of the workspace's outside the site becomes plain words; the open web stays a link.

Each of these should read as plain text on the site, with no link:

  • A draft page: the secret roadmap.

  • A deprecated page: the old API.

  • A task: CADE-911, and the task as a link.

  • A page of the app: workspace settings.

  • A person: Jonah Largen should be just a name.

Cards#

A card for a page of this site becomes a link to it by its title:

Writing great pages

A card for a draft disappears entirely (nothing should show between these two lines):

End of the cards.

Includes#

An include of a section of a page in this site shows that section:

Quotes#

Documentation is a love letter that you write to your future self.

— Damian Conway

An include of a draft shows nothing at all (nothing between these two lines):

End of the includes.