Where it comes from#
Each organization and each team has its own knowledge, written by its own assistant. A team’s is kept from its members’ work: their own wikis and the work notes in their journals (notes, facts, action items and work), from when each joined the team. Your organization’s is kept from its teams’ wikis and what their retrospectives learn. Someone in no team adds nothing to either.
In the menu#
Under Shared knowledge, each organization you belong to lists its own knowledge, by its name, and each team you’re in.
| Feature | Description | Default |
|---|---|---|
| Every team | Shown if you hold Org, or you’re an admin or owner. It lists each of the organization’s teams, marking yours, with Open to read each one’s knowledge. If you belong to more than one organization, each has its own, named after it. | — |
Who can do what#
Your organization’s knowledge
- Everyone in the organization reads it, and comments on its wiki.
- Its admins and owners also edit its wiki, and run its lint and its retrospectives.
- Its heads-ups are sent to the people who hold Org.
A team’s knowledge
- The team’s members read it, comment on and edit its wiki, and run its lint and its retrospectives.
- People who hold Org, and the organization’s admins and owners, read it too. Unless they’re in the team, they can’t comment, edit or run anything there.
- Its heads-ups are sent to the people who hold Team on it.
Unless you can edit a wiki, the foot of each of its pages says what you can do there.
The tabs#
Your organization’s knowledge and each team’s have the same three tabs. When your organization turns the knowledge wiki or intelligence off, the tab says so, and what it already holds can still be read.
| Feature | Description | Default |
|---|---|---|
| Wiki | What the organization or team knows: pages written by its assistant, starting from an index. A citation shows what it points to, such as a meeting and its time. | — |
| Heads-ups | Short notes the wiki raises when the work needs attention soon: standing ones first, then resolved ones. | — |
| Intelligence | How the work is going: four documents rewritten from what each retrospective learns, and a log of what was learned when. About the work, never about people. | — |
Wiki#
Links between pages open here, and links to the web open in a new tab. What else you can do depends on who can do what: Run lint is there if you can run, Edit, Save and Rebuild the index if you can edit, and Comment, Reply and Resolve if you can comment.
| Feature | Description | Default |
|---|---|---|
| Run lint | Runs the wiki’s next pass now, instead of on its schedule: it folds in what’s new, and the comments. The button says Linting… while it runs. | — |
| Edit | Opens the page’s text, written in Markdown, for you to change, with the page’s details at the top. The index and the log can’t be edited. | — |
| Save | Keeps your change. The wiki tidies it as it does every change, and updates its index. If you leave the page before saving, you’re asked whether to leave without saving. | — |
| Rebuild the index | At the foot of the index: rebuilds the index from the wiki’s pages. | — |
| Comment | Select a passage on a page, and a bar offers Comment. Write what should change, and why: the wiki’s next pass reads it. | — |
| Reply | Adds your reply under a comment. | — |
| Resolve | Removes a comment once it’s dealt with. | — |
Comments and replies show who wrote them, by email address, to everyone who reads the wiki.
Heads-ups#
Everyone who reads the knowledge sees its heads-ups here.
| Feature | Description | Default |
|---|---|---|
| Open the page | Opens the wiki page a heads-up is about. | — |
Intelligence#
The four documents, and when each retrospective last ran. Run now is there if you can run.
| Feature | Description | Default |
|---|---|---|
| Progress | The projects and workstreams: where each stands, what moved, and what’s next. | — |
| Decisions | What was decided, when and why, and what was reversed or is still open. | — |
| Risks | Blockers, slipping dates and open dependencies, and what would resolve them. | — |
| Practices | How the work gets done: rituals, tools and hand-offs. | — |
| Run now | Shown under each of Daily, Weekly, Monthly and Yearly. Runs that retrospective now, over the period so far, instead of when the period is over. While one runs, the others wait. | — |
Related#
- Your assistant: your own wiki and intelligence, which your teams’ are kept from.
- Wiki & intelligence: this knowledge on the admin dashboard.
- Teams: who is in each team, and who holds Team on it.
- Knowledge wiki and Intelligence & work: what your organization turns on.
- Roles and permissions: what each role lets people do.