05 Project Structure - Observatorio-do-Trabalho-de-Pernambuco/documentation GitHub Wiki
5. Project Structure
Guidance on organizing project folders, creating README files, and managing scripts in production.
5.1 README Structure
Folder-Level Docs
- Include a README describing contents and usage
- Maintain consistent formatting (Markdown headings, code blocks)
References
- Link to scripts, environment instructions, external docs
5.2 Scripts Development
Production Code
- Ensure logging, error handling, performance considerations
Code Style Conventions
- PEP8 (if Python)
- Linters/formatters (black, flake8, etc.)
Docstrings
- Function-level docstrings with parameter and return descriptions