Skip to content

Latest commit

 

History

History
62 lines (42 loc) · 1.85 KB

File metadata and controls

62 lines (42 loc) · 1.85 KB

Contributing to Typst Templates Project

Thank you for your interest in contributing to this project! Here's how you can help.

Code of Conduct

By participating in this project, you agree to maintain a respectful and inclusive environment for everyone.

How to Contribute

Reporting Bugs

  • Check if the bug has already been reported in the Issues section
  • Include a clear title and description
  • Provide a minimal working example that reproduces the issue
  • Specify your Typst version (typst --version)

Suggesting Enhancements

  • Check if the enhancement has already been suggested
  • Include a clear title and description
  • Explain why this enhancement would be useful
  • Provide examples of how it would be used

Pull Requests

  1. Fork the repository
  2. Create a new branch for your feature or bugfix
  3. Make your changes
  4. Test compilation with typst compile to ensure your changes work
  5. Submit a pull request

Typst Style Guidelines

  • Use consistent indentation (2 spaces)
  • Follow Typst naming conventions for functions and variables
  • Include comments for complex code sections
  • Use parameters and variables instead of hardcoded values

Documentation Guidelines

  • Update documentation for any changed functionality
  • Include examples in documentation
  • Document any new functions or features with their parameters
  • Use clear, concise language

Template Guidelines

  • Templates should be minimal and well-documented
  • Include example usage in comments
  • Ensure templates compile without errors with latest Typst
  • Don't include unnecessary dependencies

Testing

  • Provide test documents that demonstrate your changes
  • Ensure your changes compile with typst compile
  • Test templates with different content types (text, math, figures, etc.)

Questions?

Feel free to open an issue for any questions about contributing. We're happy to help!