Pages

Pages are workspace knowledge documents stored in a tree. Use them for specifications, runbooks, decisions, meeting notes, and other information that belongs beside the work.

A page supports Markdown content, labels, attachments, diagrams, revision history, explicit permissions, and permission inheritance. You can also link pages to work items.

Organize the page tree

Drag a page in the tree to reorder it or move it under another parent. The page and its descendants move together.

To choose an exact destination:

  1. Open the page menu.
  2. Select Move.
  3. Choose the destination workspace.
  4. Choose a parent page or Workspace root.
  5. Confirm the move.

Windshift prevents a page from moving under itself or one of its descendants.

Move a page tree to another workspace

A cross-workspace move transfers the selected page and its complete subtree. You need edit access to the source page and create access in the destination workspace. If you select a parent, you also need edit access to that page.

Review these effects before you confirm:

  • Labels with the same name in the destination workspace are kept.
  • Explicit page permissions are removed.
  • Work-item links are removed.
  • Agent-skill references are removed.
  • Page revisions, content, attachments, diagrams, and descendants stay with the page tree.

Set the destination to Workspace root when the tree does not belong under another page.

Move pages with the CLI

Use ws page move to reparent, reorder, or transfer a page tree:

# Move page 42 under page 7 in the current workspace.
ws page move 42 --parent 7

# Move page 42 to the current workspace root.
ws page move 42 --root

# Place page 42 after sibling page 11.
ws page move 42 --parent 7 --after 11

# Move the complete subtree to the MA workspace root.
ws page move 42 --root --to-workspace MA

Use --before or --after for an exact sibling position. The two flags are mutually exclusive.

Permissions and inheritance

An open page uses the workspace page permissions. A restricted page can have explicit user or group access.

Child pages can inherit permissions from their parent. Before you move a restricted tree, review the destination policy. A cross-workspace move removes explicit page permissions so source-workspace principals do not carry into the destination.

Revisions and recovery

Windshift keeps page revision history. Open the history to compare earlier content or restore a selected revision.

Archiving a page archives its subtree. Restore an archived page before you try to move or edit it.