[FEATURE] Add an offline process-monitor manual #4

Closed
opened 2026-10-24 01:57:20 +02:00 by erikinkinen · 2 comments
Owner

Problem and motivation

Offline manuals cover the shell and standard utilities, but the native process monitor has no indexed operator page.

Proposed behavior and scope

Add an original extop(1) page and an explicit component manifest. Describe the actual option grammar, display, keys, statuses, deployment capacity and session-scoped authority. Bind the inventory to its owning sources and compose it through the existing manual writer.

Authority, security and reliability

Documentation grants no inspection or control access. Numeric job claims remain descriptive; control requires an independently delegated exact handle and matching identity, generation and session. Page selection keeps the reader's existing read-only store authority.

Acceptance criteria

  • Document implemented options, keys, examples, errors and authority without claiming unsupported behavior.
  • Maintain an explicit source-bound page manifest and freshness guard in CI.
  • Include the page in the composed image manual store.

Alternatives and tradeoffs

README remains the repository entry point; an indexed page makes operator guidance available offline beside the other commands.

Tracking and rollout

Part of the component audit and Phase 6. Coordinate Extop PR2 and Integration PR12.

## Problem and motivation Offline manuals cover the shell and standard utilities, but the native process monitor has no indexed operator page. ## Proposed behavior and scope Add an original extop(1) page and an explicit component manifest. Describe the actual option grammar, display, keys, statuses, deployment capacity and session-scoped authority. Bind the inventory to its owning sources and compose it through the existing manual writer. ## Authority, security and reliability Documentation grants no inspection or control access. Numeric job claims remain descriptive; control requires an independently delegated exact handle and matching identity, generation and session. Page selection keeps the reader's existing read-only store authority. ## Acceptance criteria - [x] Document implemented options, keys, examples, errors and authority without claiming unsupported behavior. - [x] Maintain an explicit source-bound page manifest and freshness guard in CI. - [x] Include the page in the composed image manual store. ## Alternatives and tradeoffs README remains the repository entry point; an indexed page makes operator guidance available offline beside the other commands. ## Tracking and rollout Part of [the component audit](https://git.erikinkinen.fi/erix/extop/issues/1) and [Phase 6](https://git.erikinkinen.fi/erix/integration/issues/65). Coordinate [Extop PR2](https://git.erikinkinen.fi/erix/extop/pulls/2) and [Integration PR12](https://git.erikinkinen.fi/erix/integration/pulls/12).
Author
Owner

7b3e33aa adds the operator page, explicit manifest and source-freshness guard. It documents option ordering, bounded samples, terminal keys, diagnostics and the difference between inspection and exact job control. Image inclusion remains open.

[7b3e33aa](https://git.erikinkinen.fi/erix/extop/commit/7b3e33aae0f3c589c742ab8f35530bea685273ba) adds the operator page, explicit manifest and source-freshness guard. It documents option ordering, bounded samples, terminal keys, diagnostics and the difference between inspection and exact job control. Image inclusion remains open.
Author
Owner

Integration 6abd74c7 includes extop(1) in the composed image store. The original page, source bindings and image selection are complete.

Integration `6abd74c7` includes extop(1) in the composed image store. The original page, source bindings and image selection are complete.
erikinkinen added this to the Alpha 1 milestone 2026-10-30 09:33:52 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
erix/extop#4
No description provided.