At the beginning, at the end of the document, and between each section, it’s possible to create a new Section. A new section corresponds to a new artifact in the corresponding tracker and is automatically associated to the current Document.

https://www.figma.com/design/iFvG4Rs0U7FX9d5TqUkYN7/%F0%9F%91%91-Artidoc?node-id=1313-11512&t=5m8EM13aKF6gBK86-1

Selection of a tracker

In order to be able to add a section, a tracker must be associated to the artidoc. The association is weak:

• It can be changed without having an impact on the content of the document
• It only affects creation of new sections

While it's possible to add artifacts of any project, in this first iteration, only the trackers of the current project are proposed. We will see if the need of cross project documents arise.

At document creation

When a new artidoc is created, the document writer is invited to select a tracker to be associated to the Document

https://www.figma.com/design/iFvG4Rs0U7FX9d5TqUkYN7/%F0%9F%91%91-Artidoc?node-id=1313-10477&t=L4JnP2VYpG5mHoUe-1

If someone without document edition permission browse the document, they only see the tumbleweed empty state.

During document lifetime

When an artidoc already has content, the content of the document is displayed even if no tracker is associated to the Document.

However, it's not possible to add new sections.

If a tracker is already configured, it's possible to change the association.

https://www.figma.com/design/iFvG4Rs0U7FX9d5TqUkYN7/%F0%9F%91%91-Artidoc?node-id=1313-10477&t=L4JnP2VYpG5mHoUe-1