Pages are the best way to document stable information, like processes, long-term plans, how-tos, company policies, etc.

Pages, as opposed to Posts, usually don’t have comments because the content doesn’t need to be discussed, just documented. The date when they’re created or updated is often irrelevant too.

With pages, collaboration happens as multiple people edit them. Conceptually, they’re equivalent to a Google Doc or a wiki page. You can read more about the differences between posts and pages in this document.


We use pages for these types of content:

  • Roadmaps and longer term plans.
  • Meetup details — dates, hotel address, nearby restaurants, planned activities, etc.
  • Lists or tables of items — for example, a list of customers that any team member can update.
  • Team’s values and core principles, or a code of conduct.
  • Handbooks and onboarding instructions.
  • Documenting processes.
  • Bookmarks and useful links.

As you can see, this types of content usually stay relevant for long periods of time, and tend to evolve throughout time as people edit them.

Sometimes, defining the content requires several posts and discussions (for example, agreeing on a specific process). Once that’s decided, it makes sense to document it in a page.

#layout-hide-tags, #to-polish