Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

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

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /