minor

Author: denisecase

.editorconfig

@@ -1,6 +1,7 @@
 # ============================================================
 # .editorconfig (Standardize across editors and IDEs)
 # ============================================================
+# Updated: 2024-06-04
 # REQ.UNIVERSAL: All professional GitHub project repositories MUST include .editorconfig.
 # WHY: Establish a cross-editor baseline so diffs stay clean and formatting is consistent.
 # ALT: Repository may omit .editorconfig ONLY if formatting is enforced equivalently by CI and formatter tooling.

.gitattributes

@@ -1,5 +1,5 @@
 # ============================================================
-# .gitattributes (Cross-platform line endings, GH languages)
+# .gitattributes (Keep files consistent across operating systems)
 # ============================================================
 # Updated: 2026-06-04
 

.gitignore

@@ -1,3 +1,7 @@
+# ============================================================
+# .gitignore (Keep unnecessary files out of the repository)
+# ============================================================
+
 # REQ.UNIVERSAL: Spec repositories MUST ignore editor, OS, and transient artifacts.
 # WHY: Prevent accidental commits of local or generated noise.
 # ALT: Expand only if the repository adds tooling that generates artifacts.

.markdownlint-cli2.yaml

@@ -8,56 +8,65 @@
 # Run with:
 # npx markdownlint-cli2 --fix
 
+# === Set the scope of files to check ===
+
+# Check these types of files
 globs:
   - "**/*.md"
 
+# Do not check these files or directories
 ignores:
   - ".lake/**"
   - "**/.lake/**"
-  - ".venv/**"
-  - "**/.venv/**"
-  - "node_modules/**"
-  - "**/node_modules/**"
-  - "site/**"
-  - "**/site/**"
-  - "dist/**"
-  - "**/dist/**"
-  - "build/**"
-  - "**/build/**"
-  - ".ruff_cache/**"
-  - "**/.ruff_cache/**"
-  - ".pytest_cache/**"
-  - "**/.pytest_cache/**"
   - ".mypy_cache/**"
   - "**/.mypy_cache/**"
+  - ".nox/**"
+  - "**/.nox/**"
   - ".pyright/**"
   - "**/.pyright/**"
+  - ".pytest_cache/**"
+  - "**/.pytest_cache/**"
+  - ".ruff_cache/**"
+  - "**/.ruff_cache/**"
   - ".tox/**"
   - "**/.tox/**"
-  - ".nox/**"
-  - "**/.nox/**"
   - ".uv-cache/**"
   - "**/.uv-cache/**"
+  - ".venv/**"
+  - "**/.venv/**"
+  - "build/**"
+  - "**/build/**"
+  - "dist/**"
+  - "**/dist/**"
   - "htmlcov/**"
   - "**/htmlcov/**"
+  - "node_modules/**"
+  - "**/node_modules/**"
+  - "site/**"
+  - "**/site/**"
   - "LICENSE"
   - "CODEOWNERS"
 
+
+# === Configure rules ===
+
 config:
-  default: true # WHY: This enables all default rules, which is a good starting point for linting Markdown files.
+
+  default: true # WHY: Enables all default rules, which is a good starting point for linting Markdown files.
 
   MD013:
     line_length: 100
-    headings: false # WHY: This allows long headings, which can be necessary for clarity and SEO in Markdown files.
-    tables: false # WHY: This allows long table cells, which can be necessary for readability and completeness in Markdown files.
-    code_blocks: false # WHY: This allows long lines in code blocks, which can be necessary for readability and completeness in Markdown files.
+    headings: false # WHY: Allows long headings for clarity and SEO in Markdown files.
+    tables: false # WHY: Allows long table cells for readability and completeness in Markdown files.
+    code_blocks: false # WHY: Allows long lines in code blocks for readability and completeness in Markdown files.
 
-  MD025: false # WHY: This allows multiple top-level headings, which can be necessary in Markdown files that are not strictly linear documents (e.g., README files, documentation index files).
+  MD025: false # WHY: Allow multiple H1 headings when a file is not a linear document.
 
   MD033:
     allowed_elements:
-      - mark # WHY: Mark elements are often used in Markdown files for highlighting, and this allows them without triggering a lint error.
-      - meta # WHY: Metadata is often needed in Markdown files, and this allows it without triggering a lint error.
-      - link # WHY: Links are common in Markdown files, and this allows them without triggering a lint error.
-      - details # WHY: Details elements are often used in Markdown files, and this allows them without triggering a lint error.
-      - summary # WHY: Summary elements are often used in Markdown files, and this allows them without triggering a lint error.
+      - details # collapsible sections
+      - img     # images
+      - link    # links
+      - mark    # highlighting
+      - meta    # metadata
+      - summary # summary elements

.pre-commit-config.yaml

@@ -1,9 +1,8 @@
 # ============================================================
 # .pre-commit-config.yaml (Markdown Hygiene)
 # ============================================================
-# Updated: 2026-05-23
-
-# Fast, consistent repo hygiene before commit.
+# Updated: 2026-06-04
+# WHY: Fast, consistent repo hygiene before commit.
 #
 # These hooks complement and do not replace:
 # - .editorconfig
@@ -20,8 +19,8 @@
 
 exclude: |
   (?x)^(
-    \.DS_Store|
     \.coverage|
+    \.DS_Store|
     \.ipynb_checkpoints/|
     \.mypy_cache/|
     \.nox/|
@@ -30,6 +29,7 @@ exclude: |
     \.tox/|
     \.venv/|
     .*\.(egg-info)/|
+    .*\.log|
     __pycache__/|
     _minted.*/|
     build/|
@@ -39,8 +39,9 @@ exclude: |
     lake-packages/|
     node_modules/|
     out/|
-    site/ |
-    LICENSE
+    site/|
+    LICENSE|
+    CODEOWNERS
   )
 
 repos:

README.md

@@ -47,7 +47,7 @@ uvx pre-commit install
 npx markdownlint-cli2 --fix
 uvx pre-commit run --all-files
 
-# generate CODEOWNERS and check
+# generate and check CODEOWNERS
 uvx se-codeowners generate --strict --output .github/CODEOWNERS
 uvx se-codeowners check
 
@@ -71,3 +71,19 @@ git push -u origin main
 git tag vX.Y.Z -m "X.Y.Z"
 git push origin vX.Y.Z
 ```
+
+## Authority Manifest
+
+[.accountability/surfaces.toml](./.accountability/surfaces.toml)
+
+## Citation
+
+[CITATION.cff](./CITATION.cff)
+
+## License
+
+[MIT](./LICENSE)
+
+## Repository Manifest
+
+[SE_MANIFEST.toml](./SE_MANIFEST.toml)