feat(profile): rewrite org README for full-portfolio overview#19
Merged
Conversation
The previous profile/README.md pitched dryvist as Cribl-only and listed just 3 repos. The org now hosts ~35 active repos spanning Nix, Terraform, Ansible, AI tooling, observability, and dev templates — anyone landing on github.com/dryvist got a wildly inaccurate picture. Replace with a category-level overview (six buckets, no per-repo enumeration) and heavy CTAs pointing at docs.jacobpevans.com as the canonical architecture site. Voice and visual palette mirror the JacobPEvans personal profile README (Reef Green primary, Coral CTA, centered shields.io badges). Add scoped profile/.markdownlint-cli2.yaml and profile/.readme-validator.yaml so the org profile follows the same loosened rules already proven on the JacobPEvans personal-profile repo — inline HTML for centered layouts, no Installation/Usage requirement on a landing page. Repo-root configs continue to govern every other markdown file at the strict defaults. Assisted-by: Claude:claude-opus-4-7
…ry detail Triple the length while staying category-only (no per-repo enumeration): - Add a Mermaid flow diagram (Reef Green / Coral palette) showing the Human → AI Agents → dryvist repos → Automation loop, matching the visual identity of the JacobPEvans personal profile README. - Expand each of the 6 categories from a one-line bullet to a paragraph plus 3-5 sub-bullets describing capability classes. - Add "How it fits together" — a 5-layer narrative (Nix → IaC → Config → Observability → AI control plane) for readers who want the architecture before drilling into individual repos. - Add "AI-native by default" explaining the canonical instruction layer, multi-model PR review, scheduled routines, and AI telemetry. - Add "Where this fits in a larger picture" clarifying the dryvist ↔ JacobPEvans-personal account split. - Replace the 3-bullet standards list with an 11-row table covering license, commits, releases, lint/format, workflow security, dep updates, AI policy, and runner choice. - Add status-shield badge row (Apache-2.0, Conventional Commits, multi-AI-reviewed, Renovate) under the banner and a second docs CTA at the bottom. Source grows from 101 to 323 lines; all rendering routed through docs.jacobpevans.com as the canonical map. Assisted-by: Claude:claude-opus-4-7
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs.jacobpevans.comthe dominant CTA — two badge callouts plus an inline link per category, since the docs site is the canonical map.JacobPEvans/README.md(Reef Green primary#4FB3A9, Coral CTA#E06B4A, centered shields.io badges).Why the old README was broken
It pitched dryvist as "Cribl pack development" and listed three repos. The org actually hosts ~35 active repos spanning every category above. The page also never linked to
docs.jacobpevans.com.Scoped configs
Two new files under
profile/, scoped to the org-profile README only — the repo-root configs continue to govern every other markdown file at the strict defaults:profile/.markdownlint-cli2.yaml— disablesMD013(long badge URLs), allows the HTML elements needed for centered layouts (a,div,em,img,p,picture,source).profile/.readme-validator.yaml— replaces the generic Installation/Usage requirement with profile-appropriate sections (What lives here).Mirrors the pattern already proven on
JacobPEvans/.markdownlint-cli2.yamlandJacobPEvans/.readme-validator.yaml.Test plan
npx markdownlint-cli2 "profile/README.md"— 0 errorsnpx markdownlint-cli2 "**/*.md"— 6 files, 0 errors (no regressions on other READMEs)https://github.com/dryvist, confirm badges render, CTA visible above the fold