Skip to content
EmargenEmargenDocs

WorkspacePage by page

The Landscape

The Landscape holds the names your organisation uses for its systems, its people and roles, and its terms, with what each one means. Open it from Landscape under Workspace in the menu. The workspace agent sits on the left. Here it asks what your organisation has. Name a system, a role or a term, and it proposes it for the Landscape.

Open the Landscape (opens Emargen in a new tab)

It opens on Systems, with ACME’s listed.

Workspace › Landscape: Systems, People and roles and Terms; a Find a system box; Systems 17 with Groups and New system; a table with the columns Name, Also called and Code, under ACME's systems (8, The services and apps ACME builds and runs.), Regions and Outside ACME, each entry with its definition under it, identity-service first with Events outbox and Approval routing set in under it.Workspace › Landscape: Systems, People and roles and Terms; a Find a system box; Systems 17 with Groups and New system; a table with the columns Name, Also called and Code, under ACME's systems (8, The services and apps ACME builds and runs.), Regions and Outside ACME, each entry with its definition under it, identity-service first with Events outbox and Approval routing set in under it.
  1. Systems, People and roles and Terms. Click one to see it.
  2. Find a system. Type to find an entry, or pick a filter (see Filters). On People and roles it reads Find a person or role.
  3. Systems 17. The kind, and how many entries it has.
  4. Groups. Opens the kind’s groups.
  5. New system. Adds an entry of this kind on its own page. On the other kinds it reads New person or role and New term.
  6. A group, with how many entries it holds and what belongs in it. The arrow folds it. Entries with no group are under Other.
  7. An entry: the name the agents write, with its definition under it. Click its row for more (see An entry).
  8. Also called. Other names people or the code use. The agents recognise them and write the entry’s name instead.
  9. Code. For a system, the repositories its code lives in.
  10. An entry that’s part of another: Approval routing is part of identity-service.

People and roles and Terms work the same way. ACME’s roles are grouped At a customer and At ACME, its terms under Access, Customers, Data and security, Rollouts and Sign-in.

People and roles 15: At a customer, with Administrator, Depot worker, IT administrator, Regional manager, Depot manager with Team manager under it, and Site manager; then At ACME, with Customer success, Support, Sales engineer and more; each with its definition, and most with what else it's called.People and roles 15: At a customer, with Administrator, Depot worker, IT administrator, Regional manager, Depot manager with Team manager under it, and Site manager; then At ACME, with Customer success, Support, Sales engineer and more; each with its definition, and most with what else it's called.

An entry

Section titled “An entry”

Click an entry’s row. Edit and Remove show under it, and its details open on the right.

identity-service picked: under its row, Edit and Remove; on the right, its definition, Also called Identity service, Under ACME's systems, Under it Events outbox and Approval routing, Code identity-service, In topics ACM-319 with the line its map says, Changed by a long list of initiatives from ACM-247 on, and History, Added by Ana Ruiz · 29 Apr.identity-service picked: under its row, Edit and Remove; on the right, its definition, Also called Identity service, Under ACME's systems, Under it Events outbox and Approval routing, Code identity-service, In topics ACM-319 with the line its map says, Changed by a long list of initiatives from ACM-247 on, and History, Added by Ana Ruiz · 29 Apr.
  1. Edit and Remove. Change the entry on its page, or take it out (see below).
  2. Its details hold the definition, Also called, Under (its group, or the entry it’s part of), Under it (the entries that are part of it) and Code.
  3. In topics. Topics whose maps name the entry, each with the map’s line about it.
  4. Changed by. Initiatives that add or change it.
  5. History. The last 20 changes, newest first: who made each one, or turned it down, and when.

In topics and Changed by show only what you can open, and don’t show when nothing names the entry.

Remove asks first. For someone who may approve Landscape changes:

The dialog Remove identity-service from the Landscape? saying Agents stop using it. Decompositions already written keep the name they used. With Cancel and Remove.The dialog Remove identity-service from the Landscape? saying Agents stop using it. Decompositions already written keep the name they used. With Cancel and Remove.

For everyone else it asks “Propose removing identity-service?”. Someone who may approve decides, and until then the agents keep using it.

Filters

Section titled “Filters”

Click the search box for its filters. Group narrows the kind to one of its groups, and shows as a token in the box. While proposals wait, approvers also have Waiting for approval, with how many wait. Click × on a token to take it off.

The list under Find a system: under Quick, Waiting for approval, 1; under Filter by, Group.The list under Find a system: under Quick, Waiting for approval, 1; under Filter by, Group.

Waiting for approval

Section titled “Waiting for approval”

Every change to the Landscape, from a person or an agent, is a proposal. It reaches the agents only once someone approves it. Pick Waiting for approval to see the proposals of all three kinds. Click one to decide it.

Waiting for approval: the filter in the search box; one proposal, New term, Region step, proposed by Mira Holm, with its definition and where the name came from, ACM-296 and ACM-395; under it Approve, Edit, Another name for… and Reject.Waiting for approval: the filter in the search box; one proposal, New term, Region step, proposed by Mira Holm, with its definition and where the name came from, ACM-296 and ACM-395; under it Approve, Edit, Another name for… and Reject.
  1. Remove Waiting for approval. Takes the filter off.
  2. The proposal would add an entry of a kind (here New term), change one, or remove one.
  3. Proposed by. A person, an agent (and how many of its runs found the name), or a repository analysis.
  4. Its definition, and where the name came from. Click an initiative or a topic to open it.
  5. Approve. Adds it as proposed. The agents use it from then on.
  6. Edit. Opens the proposal’s page, to change it before you approve it.
  7. Another name for…. Keeps the proposed names as other names of an entry you already have. Only a proposal to add has it.
  8. Reject. Turns it down, with a note.

Another name for… asks which entry, and Add as another name stays greyed until you pick one:

The dialog Add Region step as another name for, with an Entry box and the line It joins that entry's Also called, and no new entry is added., and Cancel and Add as another name.The dialog Add Region step as another name for, with an Entry box and the line It joins that entry's Also called, and no new entry is added., and Cancel and Add as another name.

Reject asks for a note, which you may leave empty:

The dialog Reject Region step? with a box Note for whoever proposed it, marked Optional, and Cancel and Reject.The dialog Reject Region step? with a box Note for whoever proposed it, marked Optional, and Cancel and Reject.

Each approver also has the proposal in Decisions, under Landscape, and whoever decides first decides for everyone. Whoever proposed it isn’t told. An approved entry shows on the Landscape, with the approver in its History. A rejected change or removal shows in the entry’s History as Rejected by. Every decided proposal, with its note, is on the Decision Map, where everyone reads it. See Approve a Landscape proposal.

Empty

Section titled “Empty”

With no systems yet, the page says “No systems yet” and “Agents propose entries they find in your organisation’s work. Add one with New system.” When the search finds nothing: “Nothing matches these words.” When the last proposal is decided, Waiting for approval says “Nothing is waiting for approval.”

On a phone

Section titled “On a phone”

On a phone, Conversation and Workspace switch between the workspace agent and the Landscape.

The Landscape on a phone: Conversation and Workspace at the top, Workspace picked; Systems, People and roles and Terms; Find a system; Systems 17 with Groups and New system; and the table, its Code column off to the right.The Landscape on a phone: Conversation and Workspace at the top, Workspace picked; Systems, People and roles and Terms; Find a system; Systems 17 with Groups and New system; and the table, its Code column off to the right.

Access

Section titled “Access”

Everyone in the organisation reads the Landscape and proposes changes, with New system (or the other kinds’ New), Edit and Remove. Administrators, and others whose role lets them approve Landscape changes, change it directly and see Waiting for approval.