Pages that add to a wider page

The same subject can come up in more than one place. Everyone may have a page on code review, Engineering its own view of it, and you yours. Instead of three pages, the narrower place’s page adds to the wider one:

• a group’s page can add to Everyone’s page;
• your own page, in Just me, can add to Everyone’s page or to one of your groups’ pages.

How it reads

The wider page reads as it always does. Beneath it, what each narrower place adds is shown under that place’s name, like “Engineering”. It says only what that place adds, narrows, or disagrees with, such as “Engineering wants two reviewers on migrations”. It doesn’t repeat the wider page.

The narrower page says where it belongs: Adds to Everyone’s (or a group’s) page, with its title linked.

In the sidebar, the subject is listed once, under the wider page, with small marks for the places that add to it.

Read it as

On a page that others add to, Read it as, in the side column, shows exactly what each set of readers sees: the page’s own readers (Everyone, on Everyone’s page), each group by name, or You, which shows every part you can read. Use it to check what someone will see before you send them a link.

Who sees what’s added

Only people who can read the narrower place see what it adds. Someone outside Engineering reads Everyone’s page with no sign that Engineering added anything, and what you add is seen only by you. Adding to a wider page never shows anything to more people.

Add it there, or keep it separate

Cranes decides when a page adds to a wider one: when someone looking for the wider page would expect to find it there. A page about something the wider page doesn’t cover stays a page of its own.

When Cranes isn’t sure, the narrower page says This may add to a place’s page. Anyone who reads the narrower page can choose:

• Add it there: it’s rewritten as what it adds, and reads beneath the wider page.
• Keep it separate: it stays a page of its own.

A page that already adds to a wider one has Keep it separate beside its Adds to line. Your choice sticks through later learning and redrafts.

If the wider page is archived or retired, the pages that added to it stand alone again and are written whole.