docs: fix 16 discrepancies found by cross-validating all docs against source code

CLI syntax corrected across 5 files (concepts, demo-guide, demo-advanced,
architecture, features): list-certs→certs list, get-cert→certs get, etc.
Removed non-existent health/metrics commands, replaced with status.
Subcommand count 10→12 everywhere.

architecture.md: Go 1.22→1.25, endpoint count 91→93, ER diagram expanded
from 15 to 21 tables (added renewal_policies, certificate_revocations,
discovered_certificates, discovery_scans, network_scan_targets).

connectors.md: added GenerateCRL and SignOCSPResponse to issuer interface,
added Email and Webhook rows to notifier config table.

compliance docs: fixed keygen warning messages to match actual log output,
CERTCTL_STEPCA_PROVISIONER_KEY→CERTCTL_STEPCA_KEY_PATH, openssl genrsa→
crypto/ecdsa.GenerateKey, CERTCTL_SERVER_ADDR→CERTCTL_SERVER_HOST+PORT.

README.md: v2.0.0 version bump, solo developer mention, feature list,
table of contents, documentation table moved to top, 7 fact-check fixes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
shankar0123
2026-03-25 03:48:13 -04:00
parent 963821a681
commit 72cda5877a
10 changed files with 175 additions and 76 deletions
+10 -10
View File
@@ -875,28 +875,28 @@ export CERTCTL_SERVER_URL="http://localhost:8443"
export CERTCTL_API_KEY="test-key-123"
# List certificates (JSON or table format)
./certctl-cli list-certs --format table
./certctl-cli certs list
# Get certificate details
./certctl-cli get-cert mc-demo-api
./certctl-cli certs get mc-demo-api
# Trigger renewal
./certctl-cli renew-cert mc-demo-api
./certctl-cli certs renew mc-demo-api
# Revoke a certificate with RFC 5280 reason
./certctl-cli revoke-cert mc-demo-payments --reason keyCompromise
./certctl-cli certs revoke mc-demo-payments --reason keyCompromise
# List agents
./certctl-cli list-agents
./certctl-cli agents list
# List pending jobs
./certctl-cli list-jobs
./certctl-cli jobs list
# Check system health
./certctl-cli health
# Check system health and stats
./certctl-cli status
# Export metrics
./certctl-cli metrics --format json
# JSON output format
./certctl-cli --format json status
# Bulk import certificates from a PEM file
./certctl-cli import /path/to/certificates.pem