create-pmos 0.516.0 → 0.518.0

package/workspace/guide/timeline.md

@@ -1,70 +0,0 @@
----
-type: Guide
-title: "Breakdown › Timeline: the items on a time axis"
-description: "How to read the Timeline view of a Breakdown, move the dates of an item by dragging its bar, change a due date by dragging the end of a bar, and read the health flags."
-timestamp: 2026-10-05
----
-
-# Breakdown › Timeline: the items on a time axis
-
-The Timeline view shows the items of one initiative on a time axis. Each item that has a start date or a due date has a bar. The bar runs from the start date to the due date.
-
-## Open the Timeline
-
-1. Open the Breakdown of an initiative.
-2. At the top of the Breakdown, press **Timeline**. The Timeline is next to **Tree** and **Board**.
-
-## Read the Timeline
-
-- **Months.** The months are across the top. The axis starts at the first month that has a date and stops at the last month that has a date. It always shows today and at least three months.
-- **Today.** A vertical line shows today. The label **Today** is on its own line above the month labels, next to the line.
-- **Scrolling.** The chart scrolls to the side inside its own area, on every screen width. When the Timeline opens, the chart scrolls so that today shows. The column with the titles stays in its position while the chart scrolls.
-- **All items.** The first row shows the full initiative, from the first start date to the last due date. It has one segment for each stage. A small gap shows where each stage starts, also when two stages overlap.
-- **Stage rows.** Under the first row, the items are in groups by stage. The stages are in the same order as in the Tree. Each stage row shows the dates of its items and the number of dated items, for example "Build, 3 dated items".
-- **Item rows.** Each item row shows the title, the dates and the bar. A Done item has a darker bar.
-- **Milestones.** An item that is a milestone shows a diamond on its due date. The diamond also shows on the stage row and on the first row.
-- **Proposed items.** An item that an agent proposed and that you did not keep yet has a lighter bar with a dashed edge and the signal **Proposed**. A proposed item does not make a stage bar or the first row longer.
-- **Items with no dates.** An item with no start date and no due date has no bar. A line under the chart gives the number of such items. To give an item dates, open it and set **Start** and **Due** in the item sheet.
-
-An item with only a start date or only a due date has a bar of one day.
-
-## Move the dates of an item
-
-- **Move both dates.** Drag the bar to the left or to the right. The start date and the due date move by the same number of days.
-- **Change the due date.** Drag the end of the bar (the line at its right edge). Only the due date changes. The due date cannot go before the start date.
-- **Short bars.** A bar that is narrower than about 24 pixels always moves whole. To change only its due date, use the keyboard or the item sheet.
-- **Open the item.** Press the bar without moving it. The item sheet opens.
-
-The bar shows the new dates while you drag it. When you let go, the workspace saves the change.
-
-With the keyboard:
-
-1. Press Tab until the bar has the focus.
-2. Press the Left or Right arrow key to move both dates by one day.
-3. Press Shift with the Left or Right arrow key to change only the due date.
-4. Press Enter to save. Press Escape to go back to the saved dates.
-
-If you move the focus away from a bar that has a change, the workspace saves the change. If you press Tab, the focus then goes to the next bar.
-
-What a move writes:
-
-- Each drag adds one line to `planning/runs/plan-items.jsonl`. The line is a `set` line with the dates of the item. When you change only the due date, the line has only the due date.
-- An item that has only a due date keeps only a due date when you move it.
-- A move changes one item only. The dates of other items do not change, also when they come after the item. The Timeline does not count effort in days.
-- If the workspace cannot save the change, a message gives the reason. The bar goes back to the saved dates.
-
-## Health
-
-The Timeline shows a flag only when an item is not on track. The flag is text and a small dot, on its own line under the dates of the item. The bar of the item has a coloured outline.
-
-- **At risk: starts before an item ends.** The item starts on or before the day that one of its predecessors ends. The flag names that predecessor and its due date. A Done predecessor does not cause this flag. A Done item never shows it.
-- **At risk: due on a date, not done.** The due date is before today and the item is not Done.
-- **Off track: milestone due on a date, not done.** A milestone has a due date before today and it is not Done. Its diamond has the same colour as the text of the flag.
-
-Limit: this view checks only the predecessors in the same initiative. A predecessor in a different initiative does not cause a flag here. To see such a clash, compare the dates of the two items.
-
-To remove a flag, change the dates of the item or of its predecessor, or move the item to Done.
-
-## On a phone
-
-On a narrow screen, the page does not scroll to the side: only the chart does. To move a bar, touch it and drag it to the side. A short bar takes a touch a little to its left or right. To scroll the chart, drag the empty part of a row.