Skip to content
GitHubLinkedIn

Document control (draft)

This procedure defines how ISMS documents are created, reviewed, updated, and retired so they remain accurate, findable, and auditable.

OwnerInformation Security Officer
Contactinfra@lef.tec.br
Version0.1
Last updated2025-12-24
Review cadenceOn major process changes

Applies to ISMS documentation stored in this repository under src/content/docs/.

  • Document owner: accountable for accuracy and review cadence.
  • Reviewer/approver: validates changes before publication.
  • Use a clear title: and (optional) description:.
  • Keep scope and intent explicit (policy vs procedure vs reference).
  • Prefer linking to canonical pages over duplicating facts (“one fact, one place”).
  • Changes are proposed via PR and reviewed before merge.
  • Review should confirm: scope, clarity, link hygiene, and that no secrets are included.

Publication happens when the PR is merged.

  • Update Version and Last updated when requirements change.
  • For significant changes, summarize the change in the PR description.
  • If a document is no longer valid, remove it or mark it obsolete and point to the replacement.

4. Naming and structure rules (site-specific)

Section titled “4. Naming and structure rules (site-specific)”
  • Filenames use kebab-case.mdx.
  • Use MDX comments {/* ... */} (not HTML comments).
  • Prefer stable paths; if a page must move, ensure inbound links are updated.
  • Git history (PRs + commits) is the primary record of changes and approvals.
  • Automated checks (lint) provide link hygiene and structural compliance.