Project Documentation

Preview — available from release 26.05. Schema, endpoint, and rendered UI may change or be removed at any time while the feature is in preview.

Project Documentation is a per-namespace markdown document rendered inside the platform UI. It is meant for the implementation team to surface customer-facing notes — data sources, flows, contacts, runbooks — to business users without sending them to a separate wiki.

The document is uploaded via the API and rendered as a side panel that opens alongside whichever page the user is currently viewing. A CLI command is provided for convenience but it is not the only way to upload — anything that can issue an authenticated PUT request to the platform can update the document.

Who can see and update it

Capability	Permission	Default group
View the panel	read documentation	Default group (every namespace member)
Update the document	update documentation	Owner / FullAccess group

The read documentation scope is added to the Default group during namespace bootstrap, so every authenticated namespace member can read the document. Writes are gated behind update documentation, which is included in the FullAccess group.

⚠️ This document is shared with all users. Do not include secrets, credentials, internal infrastructure details, or anything you would not want a user to see.

Where it shows up

The Documentation button in the platform top bar, to the left of the user / namespace / avatar block, opens the documentation side panel. The panel has two sources: the platform documentation page for the screen you are on (This page) and the project document uploaded for the active namespace (Project).

When a project document has been uploaded:

• If the current screen also has platform documentation, switch between This page and Project with the tabs at the top of the panel.
• If the current screen has no platform documentation, the panel shows the project document directly.
• The markdown is rendered through a sanitizing markdown pipeline.
• The panel stays open while you navigate between pages.
• It has a draggable resizer on the left edge; the chosen width is persisted in localStorage.
• It closes on Escape or by clicking the X in the panel header.

Without a project document the button still appears on screens that have platform documentation, showing only This page. On screens without either, the button is hidden.

How to upload a document

Via the API

The document is a singleton resource at:

PUT /v1/namespaces/{namespace}/documentation
GET /v1/namespaces/{namespace}/documentation

The PUT body is the ProjectDocumentation message itself:

{
  "name": "namespaces/enrx_org_001/documentation",
  "content": "# My project\n\n..."
}

The authenticated user must have the update documentation permission on the target namespace.

Via the CLI

A command is available in ewx-cli under the project-documentation group as a convenience wrapper around the API:

# Upload a markdown file as the namespace's documentation.
ewx-cli project-documentation update <namespace> <path>

# Print the current documentation for a namespace.
ewx-cli project-documentation get <namespace>

Example:

ewx-cli project-documentation update demo/enrx_org_001 ./PROJECT.md

How to keep it up to date

The recommended workflow is to keep a PROJECT.md file at the root of the implementation repo for the customer and re-upload it on every relevant change (new flow, new market adapter, new data source, contact change, etc.). Tying the upload to your deploy pipeline keeps the platform copy and the source-of-truth copy in sync.

What can be inside

Anything supported by standard CommonMark plus tables, code blocks, fenced code, ordered/unordered lists, and inline links. HTML is sanitized out of the rendered output.