# Decision record: Keep onboarding instructions in one maintained article

Fictional demonstration. Decision ID: DEMO-ADR-001. Owner: People Operations. Status: Proposed example. Reviewed at: not recorded.

## Context

In this invented scenario, several chat messages contain different instructions for requesting access. New joiners need one maintained entry point while administrators retain the real access process.

## Decision

Link onboarding checklists to procedure-request-project-access.md. Keep approval and access provisioning in the designated operational system. The knowledge base explains the process and links to the request reference.

## Alternatives considered

- Copy the complete procedure into every checklist: easy to read, harder to keep consistent.
- Link only to a chat thread: preserves history, but the latest applicable instruction may be unclear.

## Consequences

The owner must keep the article current and check incoming links after changes. This decision does not claim a measured productivity improvement.

## Revisit when

The request channel, role model, or designated administrator changes. Record the actual decision and review date after the real team approves its own version.
