Skip to content

docs: add Organization lexicon reference page#132

Open
s-adamantine wants to merge 1 commit intomainfrom
docs/add-organization-lexicon
Open

docs: add Organization lexicon reference page#132
s-adamantine wants to merge 1 commit intomainfrom
docs/add-organization-lexicon

Conversation

@s-adamantine
Copy link
Copy Markdown
Contributor

@s-adamantine s-adamantine commented Apr 23, 2026

Summary

  • Adds a new reference page at /lexicons/certified-lexicons/organization for app.certified.actor.organization, documenting the organization actor record that complements profile with legal structure, founded date, location, reference URLs, long-form description, and visibility.
  • Calls out the longDescription union (inline string / embedded Leaflet linear document / strongRef) and the visibility field (public / unlisted) that were recently added in the lexicon repo.
  • Wires the new page into the Certified Lexicons sidebar (lib/navigation.js) and the index table (pages/lexicons/certified-lexicons/index.md).

The body follows the same thin-overview-plus-link style used by the other Certified lexicon pages (Profile, Location, Badge Definition, etc.) — deferring the authoritative field list to the lexicon JSON on GitHub.

Test plan

  • pnpm dev — confirm the new page renders and appears in the sidebar under Certified Lexicons → Organization
  • Confirm the schema link resolves to app.certified.actor.organization
  • Confirm the internal links to Profile and Location resolve

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added a new Organization lexicon page with corresponding navigation entry in the Certified Lexicons section for referencing organization actor records.
  • Documentation

    • Introduced comprehensive reference documentation for the Organization lexicon, covering organization metadata fields, supported description formats (inline string, embedded document, or reference link), and visibility controls for public or unlisted organization actors.

Adds a reference page for app.certified.actor.organization, the
organization-actor record that complements profile with legal
structure, founded date, location, reference URLs, and a long-form
description (inline string, embedded Leaflet linear document, or
strongRef). Also documents the `visibility` field for public/unlisted
discoverability.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
hypercerts-atproto-documentation Ready Ready Preview, Comment Apr 23, 2026 9:25am
hypercerts-v0.2-documentation Ready Ready Preview, Comment Apr 23, 2026 9:25am

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 23, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: baf9aa74-6298-4a1e-ba45-08d8c8996c72

📥 Commits

Reviewing files that changed from the base of the PR and between f52d8ef and 142e702.

📒 Files selected for processing (4)
  • .beads/issues.jsonl
  • lib/navigation.js
  • pages/lexicons/certified-lexicons/index.md
  • pages/lexicons/certified-lexicons/organization.md

📝 Walkthrough

Walkthrough

This pull request adds documentation for a new Certified Lexicon called "Organization" (NSID: app.certified.actor.organization). The changes include adding a navigation entry, an index table row describing the lexicon, and a new documentation page detailing the organization record structure and metadata fields.

Changes

Cohort / File(s) Summary
Navigation Configuration
lib/navigation.js
Added a new navigation entry for the Organization lexicon page under the Certified Lexicons section.
Organization Lexicon Documentation
pages/lexicons/certified-lexicons/index.md, pages/lexicons/certified-lexicons/organization.md
Added a table row to the index referencing the Organization lexicon and created a new documentation page describing the singleton organization actor record, its metadata fields (legal structure, founded date, location, reference URLs), supported description formats, and visibility settings.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A new organization joins the lexicon tree,
With paths and metadata, organized so spree,
The navigation knows, the docs are bright,
Another certified actor shining in the light! 📚

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title 'docs: add Organization lexicon reference page' accurately describes the main change—adding documentation for a new Organization lexicon reference page.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/add-organization-lexicon

Comment @coderabbitai help to get the list of available commands and usage tips.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant