Getting Started

Use this page as the starting point for understanding OrganicOS, contributing to its documentation, or preparing the project for a cleaner public handoff.

If You Are Visiting

Start with the public story:

1. Read About OrganicOS.
2. Read the OrganicOS Overview.
3. Open the Developer page for Shane’s public profile and handoff links.
4. Use the Gallery for current visual identity and project media.

If You Are Reviewing Source

Start with the cleanup path:

1. Read the Repository Map.
2. Read the GitHub Cleanup Plan.
3. Check the Documentation Inventory before writing new claims.
4. Treat every repository as private until it has passed a redaction review.

If You Are Maintaining The Portal

Add or update Markdown files under:

src/content/docs/docs/

Each docs page should include frontmatter:

---
title: Page title
description: Short page summary.
category: Operations
version: local-phase-1
status: Needs Review
tags:
  - diagnostics
lastReviewed: 2026-07-23
---

Review Status Rules

Use Needs Review for information that still needs to be checked against the local OrganicOS project.

Use Draft for information that has a clear evidence basis but still needs wording, redaction, or completeness review.

Use Verified only after the page has a clear source trail and is safe to publish.

Public Safety Rules

Do not publish:

• credentials, tokens, API keys, or browser session material;
• private service URLs, private hostnames, or unreviewed network maps;
• WSL artifacts or handoff material that may preserve user state;
• generated caches, build output, or local backups;
• claims about supported installation or release artifacts that have not been built and tested.

When uncertain, leave the content in the Portal as Needs Review and link to the source-backed inventory instead of writing a final guide.