THD-Spatial GitHub Template¶
Welcome to the THD-Spatial GitHub Template documentation! This template helps group members create standardized, open-source ready repositories.
Quick Overview¶
This template repository provides a complete starting point for open-sourcing projects under the THD-Spatial organization. It includes essential files, guidelines, and a comprehensive checklist to ensure your project meets all requirements.
What's Included¶
- Essential Documentation Templates: LICENSE, README, CONTRIBUTING
- Open Source Checklist: Step-by-step verification of requirements
- Git LFS Configuration: For managing large data files
- MkDocs Setup: For creating project documentation sites
- Repository Naming Guidelines: Best practices for consistent naming
- Additional Document list: Optional but useful files for project maintenance and community engagement
Getting Started¶
-
Use this template: Click
Use this template -> Create a new repositorybutton on GitHub
-
Name your repository: Follow the Repository Naming Guidelines
- Complete checklist: Use Open Source Checklist to track progress
- Customize files: Update all template files for your specific project
- Make it public: Once all requirements are met, publish your repository
Key Requirements¶
Before Going Public
Your repository must include a LICENSE file before it can be made public under the THD-Spatial organization.
Essential Files¶
- LICENSE - Required for all public repositories
- README.md - Project overview and documentation
- CONTRIBUTING.md - Guidelines for contributors
- CODE_OF_CONDUCT.md - Community standards
Data Management¶
- Git LFS - Required for repositories with large data files
Next Steps¶
- Open Source Checklist - Complete all requirements
- Repository Naming Guidelines - Learn about naming conventions
Support¶
For questions or issues with this template, please open an issue or contact the THD-Spatial group administrators.