Skip to content

Comprehensive documentation for workflow-kit GitHub Actions workflows

Notifications You must be signed in to change notification settings

workflow-kit/docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

workflow-kit Documentation

Comprehensive documentation for workflow-kit GitHub Actions workflows

Deploy Docs

πŸ“š Documentation

Visit the documentation site: workflow-kit.github.io/docs

πŸš€ Quick Start

This documentation is built with MkDocs Material.

Local Development

# Install dependencies
pip install -r requirements.txt

# Serve locally
mkdocs serve

# Access at http://localhost:8000

Build

# Build static site
mkdocs build

# Output in site/ directory

πŸ› οΈ Stack

  • MkDocs β€” Static site generator
  • Material for MkDocs β€” Theme
  • Mermaid β€” Diagrams
  • GitHub Pages β€” Hosting

πŸ“‚ Structure

docs/
β”œβ”€β”€ docs/                      # Documentation source
β”‚   β”œβ”€β”€ index.md              # Homepage
β”‚   β”œβ”€β”€ getting-started.md    # Getting started guide
β”‚   β”œβ”€β”€ workflows/            # Workflow documentation
β”‚   β”‚   └── pr-auto-labeler/  # PR Auto-Labeler workflow
β”‚   └── assets/               # Images and static files
β”œβ”€β”€ mkdocs.yml                # MkDocs configuration
β”œβ”€β”€ requirements.txt          # Python dependencies
β”œβ”€β”€ Dockerfile               # Docker build
└── .github/workflows/       # GitHub Actions
    └── deploy-docs.yml      # Auto-deploy to GitHub Pages

πŸ”„ Deployment

Documentation is automatically deployed to GitHub Pages when changes are pushed to main branch.

The deployment workflow:

  1. Installs dependencies
  2. Builds the MkDocs site
  3. Deploys to gh-pages branch
  4. GitHub Pages serves the site

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test locally with mkdocs serve
  5. Submit a pull request

πŸ“ License

MIT License - see LICENSE for details.


Made with ❀️ by the workflow-kit team

About

Comprehensive documentation for workflow-kit GitHub Actions workflows

Resources

Stars

Watchers

Forks

Packages

No packages published