Pages that add to a wider page
How a group’s page, or your own, can add to a wider place’s page on the same subject, and how to see what each set of readers sees.
The same subject can come up in more than one place. Everyone may have a page on code review, Engineering may hold its own view of it, and you may have yours. Rather than three pages on one subject, a narrower place’s page can add to a wider place’s page.
- 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 with that place’s name, like “Engineering” or “You”. It says only what that place adds or does differently, 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.
Read it as
On a page that others add to, Read it as shows exactly what each set of readers sees: Everyone, a group by name, or You. Choose one to see the page as those people read it. It’s a quick way to check what you’d be sharing before you send someone 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. What you add is seen only by you. Adding to a wider page never shares anything with more people.
In the sidebar
Under Pages, a page that others add to is listed once, with small marks for the places that add to it. You don’t see the same subject listed three times.
Who decides
Cranes decides when a page adds to a wider one: when someone looking for the wider page would expect to find it there, because it’s about the same practice or call and adds to it, narrows it, or disagrees with it. A page about something the wider page doesn’t cover stays a page of its own.
When Cranes isn’t sure, the narrower page asks: This may add to a place’s page, with its title. Choose:
- Add it there, and it reads beneath the wider page as what that place adds.
- Keep it separate, and it stays a page of its own.
A page that was added reads Adds to a place’s page, with Keep it separate beside it if you’d rather it stood alone.
Your choice sticks. Later learning keeps a page where you put it, through redrafts.
When the wider page goes
If the wider page is retired or merged, the pages that added to it become pages of their own again, keeping what they say.