MokoConsulting/mokocli
Public Access
1
0
Fork 0
Code Issues 2 Pull Requests Releases 8 Wiki Activity
Page: Documentation-Standards
Pages
AUTO-CREATE-ORG-PROJECTS Branching-Strategy CLI-AUTOMATION Coding-Standards DEPLOY-SCRIPTS DOLIBARR-MODULE-IDS DRY-RUN-PATTERN Documentation-Standards File-Header-Standards JOOMLA-SYNC LEGAL-DOC-GENERATOR-WEB-README MONITORING-SCRIPTS NEW-SCRIPTS QUICKSTART-ORG-PROJECTS RELEASE-MANAGEMENT Version-Standard WIKI-STANDARDS WORKFLOW-STANDARDS api-maintenance-index api-plugin-index api-tests-index api-tests-sample-index automation-README automation-branch-version-automation automation-repo-cleanup client-repos standards-mokostandards-file-spec templates-client-waas templates-dolibarr templates-generic templates-mcp unnamed workflows-README workflows-auto-release workflows-branch-protection workflows-build-release workflows-cascade-dev workflows-changelog-management workflows-demo-deployment workflows-dev-branch-tracking workflows-dev-deployment workflows-index workflows-release-system workflows-renovate workflows-reusable-workflows workflows-rs-deployment workflows-secret-scanning workflows-shared-workflows workflows-standards-compliance workflows-static-analysis workflows-sub-issue-management workflows-update-server workflows-workflow-architecture
Clone
15
Documentation-Standards
Jonathan Miller edited this page 2026-06-21 05:40:10 +00:00
Table of Contents

← Back to Home

Documentation Standards

This is the current, authoritative documentation standards page. For the legacy version, see Documentation-Standards (legacy).

Repo Health Scoring (135 points)

Category Points Checks
Required Files 40 README (8), LICENSE (8), CHANGELOG (5), CONTRIBUTING (5), SECURITY (5), profile.ps1 (4), .mcp.json (3), .gitignore (2)
Manifest & Config 15 .mokocli manifest (5), workflows dir (5), README >500 chars (3), CODE_OF_CONDUCT (2)
Documentation 10 No docs/ directory -- wiki-first (10)
Disallowed 10 No TODO.md (5), no vendor/ (3), no node_modules/ (2)
Workflows 15 Workflows dir (5), repo-health.yml (3), sync-roadmap-wiki.yml (3), CI/deploy workflow (4)
Security 20 SECURITY.md (5), scanning workflow (5), dependency mgmt (5), no secrets (5)
Rulesets 15 Main protected (5), dev branch exists (5), rulesets configured (5)
Deployment 10 Deploy workflow (5), build system (5)

Health Levels

Level Score
Excellent 90%+
Good 80-89%
Fair 70-79%
Poor 60-69%
Critical <60%

Wiki-First Policy

Rule Enforcement
docs/ in repos NOT ALLOWED -- 10 point deduction
Documentation location MokoGitea wiki per repo
DOCS_INDEX Removed -- not checked
CHANGELOG search Root and src/ only

Required Files

Every repo must have:

  • README.md -- project overview (>500 chars for full points)
  • LICENSE -- GPL-3.0-or-later
  • CHANGELOG.md -- version history
  • CONTRIBUTING.md -- contribution guidelines
  • SECURITY.md -- security policy
  • profile.ps1 -- auto-generated PowerShell profile
  • .mcp.json -- auto-generated MCP config
  • .gitignore
  • .mokogitea/.mokocli -- repo manifest
  • .mokogitea/workflows/ -- CI/CD workflows

Disallowed

  • docs/ -- use wiki
  • TODO.md -- use MokoGitea issues
  • vendor/ -- gitignored, not committed
  • node_modules/ -- gitignored
  • .env / secret files -- never committed

Required Workflows

  • repo-health.yml -- validates against these standards
  • sync-roadmap-wiki.yml -- auto-generates roadmap from project board
  • At least one CI/deploy workflow

Branching

Branch Purpose
main Stable production release
dev Integration (always ahead of main)
feature Active feature development (merges to dev)
version Version preparation and staging
beta Beta testing channel
alpha Alpha testing channel
feature/* Named feature branches (merge to dev)
fix/* Bug fix branches (merge to dev)
hotfix/* Urgent fixes (merge to dev or main)
rc/* Release candidates (merge to main)

Feature branches never bump version numbers.

Running the Check

php validate/check_repo_health.php --path /a/MokoCRM
php validate/check_repo_health.php --path /a/MokoCRM --repo MokoConsulting/MokoCRM --json
php validate/check_repo_health.php --path /a/MokoCRM --repo MokoConsulting/MokoCRM --create-issue

Related

Repo: mokocli · mokocli wiki

Field Value
Minimum Version 04.07.00
Platform all
Applies To All repositories
Revision Date Author Description
1.0 2026-05-09 Moko Consulting Initial version
Pages