# Write a guide to your base

> A short page on what a base is for, how its tables fit together and who to ask. Everyone who opens the base can read it, and new people see it on their first visit.

Source: https://artavolo.com/page/base-guide

A base guide is a short page the owners of a base write for everyone who uses it: what the base is for, what each table holds, how the tables link, which view to use for what, and who to ask. A person sees it by themselves the first time they open the base, and again after it changes. Anyone can open it later from the base's menu.

## Write it

1. Open the base, click its name at the top left and choose **Base guide**.
2. Click **Write the guide** (or **Edit the guide** to change it).
3. Write it and click **Save**.

A guide is written with a few simple marks:

- `## What this base is for` for a heading,
- `-` at the start of a line for a list, or `1.` for a numbered one,
- `**Projects**` for bold and `*this*` for italics,
- `[the form](https://...)` for a link; a web address on its own becomes a link too.

A good guide is short: three headings (what it is for, the tables, who to ask) are enough for most bases.

## Good to know

- Only the owners of a base write its guide. Everyone who can open the base reads it, read-only members included; people invited to an interface only do not see it.
- Each person's browser remembers which version of the guide it has shown, so it opens by itself again only after the guide changes.
- A guide is up to 20,000 characters. Pictures are not shown; link to them instead.

## Related

- [Work together in a base](https://artavolo.com/page/collaboration-guide)
- [Who sees what](https://artavolo.com/page/who-sees-what)
