Files
OpenShell/.markdownlint-cli2.jsonc
krishicks cf1bbb965d docs: remove the architecture directory (#3799)
Remove architecture/. It was a constant source of merge conflicts, became
an effectively append-only log of the project, and was of dubious value.
Design records live in rfc/, crate details in crate READMEs, and user
documentation in docs/.

Move the git-ignored plans directory from architecture/plans to plans/,
keeping the old .gitignore entry. Remove the arch-doc-writer agents and
update AGENTS.md, CONTRIBUTING.md, skills, the feature request template,
and links in proto/, rfc/, and examples/ that pointed into architecture/.

Signed-off-by: Kris Hicks <khicks@nvidia.com>
2026-09-29 17:35:22 +00:00

49 lines
1.5 KiB
JSON

{
"globs": [
"*.md",
"crates/**/*.md",
"deploy/**/*.md",
"docs/**/*.md",
"docs/**/*.mdx",
"e2e/**/*.md",
"examples/**/*.md",
"rfc/**/*.md"
],
"gitignore": false,
"ignores": [
".agents/**",
".claude/**",
".opencode/**",
".github/**",
"plans/**",
"architecture/plans/**",
"**/node_modules/**",
"target/**",
".pytest_cache/**",
"THIRD-PARTY-NOTICES/**",
"CLAUDE.md",
// Man page sources use pandoc markdown with multiple H1 sections
// (NAME, SYNOPSIS, DESCRIPTION, etc.) which is standard for man
// pages but violates MD025.
"deploy/man/**"
],
"config": {
"default": true,
// Allow long lines — prose paragraphs are single-line per project style.
"MD013": false,
// Allow GitHub-rendered HTML commonly used in READMEs (centered logos,
// collapsible sections, keyboard hints). Regular prose HTML still flagged.
"MD033": { "allowed_elements": ["p", "img", "br", "a", "div", "details", "summary", "kbd", "sub", "sup"] },
// Allow duplicate headings in different sections.
"MD024": { "siblings_only": true },
// Bare URLs are fine in changelogs and tables.
"MD034": false,
// Internal docs commonly use bare fences for diagrams and terminal sketches.
"MD040": false,
// First line does not need to be a heading.
"MD002": false,
// Repo uses padded table pipes (`| foo | bar |`); rule default is "compact".
"MD060": { "style": "padded" }
}
}