Notion is a wiki-like information management tool.

<aside> 💡 Notice the backlinks at the top of the page! You can always navigate using these.

</aside>

What do we use it for?

We use this as the rapid-access note-taking system for Warpforge, and also put a good amount of the documentation here.

Almost all of the content is public.

If you’d like to help edit things, get in touch with someone (find out how in the Community page!).

What’s neat about Notion?

It’s a bit more wysiwyg than other wiki-like tools, and fairly easy to edit both in desktop and in mobile apps.

It’s also pretty similar to markdown, so developers tend to like it.

And it publishes a read-only system to the web with pretty much zero effort, which is sweet.

What’s a bummer about it?

Doesn’t support deep links into content in the middle of a page. Unfortunate for documentation.

Doesn’t support long paths, and all links get big random uids on the end. Unfortunate for documentation.

Hard to script as an input to test fixtures. Unfortunate for living documentation.

Isn’t versioned very well! Hard to look at ancient history, and there aren’t coherent diffs to review atomically. Also means we can’t have totally open editor access, because there’s just not enough damage control mechanisms available :/

The read-only web version doesn’t have the whole page nav tree rendered at once in the left sidebar, like the writable version has :/ Gosh what a silly omission.