moko-platform/templates/docs

Documentation Templates

Purpose

This directory contains governed documentation templates for the moko-platform organization. These templates ensure consistency, completeness, and compliance across all documentation artifacts.

Intended Use

Use these templates when:

• Creating new documentation files
• Establishing documentation in new repositories
• Ensuring compliance with documentation standards
• Maintaining consistency across projects

Instructions

Template Categories

Templates are organized into two categories:

1. Required Templates - /templates/docs/required/

   • Mandatory documentation files for all repositories
   • Must be present and maintained
   • Subject to compliance review

2. Extra Templates - /templates/docs/extra/

   • Optional documentation files
   • Recommended for specific use cases
   • Enhance documentation quality

Using Templates

To use a template:

1. Navigate to appropriate template category (required or extra)
2. Copy the template file to your target location
3. Rename the file removing the template- prefix
4. Replace all placeholder content with actual information
5. Complete all required fields
6. Remove example sections or mark them explicitly as examples
7. Follow the template instructions section
8. Validate against Document Formatting Policy

Template Maintenance

Templates are governed assets and must:

• Follow Document Formatting Policy requirements
• Include all required sections for templates
• Contain no production data
• Use placeholder values only
• Be reviewed per governance schedule
• Have Project task entries

Required Fields

When using templates, ensure these fields are completed:

• All section headers and content
• Metadata fields specific to the document
• Revision history
• Purpose and scope statements
• Responsibilities and governance rules (where applicable)

Example Usage

Creating a New Repository README

# Copy template to target location
cp /templates/docs/required/template-README.md /path/to/repo/README.md

# Edit the file
# - Replace "[Repository Name]" with actual repository name
# - Complete all sections
# - Update metadata
# - Customize content for your repository

Creating a New Policy Document

# Use policy template structure
# Follow /docs/policy/ examples
# Ensure all mandatory policy sections included
# Obtain required approvals per policy

Metadata

• Document Type: overview
• Document Subtype: catalog
• Owner Role: Documentation Owner
• Approval Required: No
• Evidence Required: Yes
• Review Cycle: Annual
• Retention: Indefinite
• Compliance Tags: Governance
• Status: Published

Revision History

• Initial template catalog established
• Template categories and usage instructions defined
• Template maintenance requirements documented