docs: Add comprehensive documentation hub

README.md

@@ -11,6 +11,8 @@ This repository organizes our farm records into four sections:
 
 Use this repository to find any farm document. Click a folder to explore.
 
+**📚 New to this repository?** Start with the [Documentation Hub](./docs/) for tutorials, how-to guides, and reference materials.
+
 ---
 
 ## Quick Links

docs/README.md

@@ -0,0 +1,86 @@
+# Sunny Acres Farm Documentation
+
+Welcome to the comprehensive documentation for the Sunny Acres Farm repository. This documentation helps you understand and effectively use this repository to manage farm operations.
+
+## Documentation Structure
+
+This documentation follows the [Diátaxis](https://diataxis.fr/) framework, organizing content into four types:
+
+### 📚 [Tutorials](./tutorials/)
+**Learning-oriented** — Step-by-step lessons for newcomers
+
+Start here if you're new to the repository. These guides walk you through your first tasks from start to finish.
+
+- [Getting Started](./tutorials/getting-started.md)
+- [Your First Issue](./tutorials/creating-your-first-issue.md)
+- [Recording Equipment Maintenance](./tutorials/recording-equipment-maintenance.md)
+
+### 🔧 [How-To Guides](./how-to/)
+**Task-oriented** — Practical steps to accomplish specific goals
+
+Use these when you need to complete a specific task or solve a particular problem.
+
+- [Adding Crop Records](./how-to/add-crop-record.md)
+- [Logging Equipment Maintenance](./how-to/log-equipment-maintenance.md)
+- [Updating Livestock Health Records](./how-to/update-livestock-health.md)
+- [Tracking Compliance Deadlines](./how-to/track-compliance-deadlines.md)
+- [Using GitHub Issues Effectively](./how-to/use-github-issues.md)
+
+### 📖 [Reference](./reference/)
+**Information-oriented** — Technical descriptions and specifications
+
+Consult these for precise details about data formats, fields, and terminology.
+
+- [Data Dictionary](./reference/data-dictionary.md)
+- [Farm Glossary](./reference/glossary.md)
+- [File Naming Conventions](./reference/naming-conventions.md)
+- [Label Reference](./reference/labels.md)
+
+### 💡 [Explanation](./explanation/)
+**Understanding-oriented** — Background, context, and design decisions
+
+Read these to understand the "why" behind farm operations and repository design.
+
+- [Farm Operations Overview](./explanation/farm-operations.md)
+- [Seasonal Calendar](./explanation/seasonal-calendar.md)
+- [Repository Design](./explanation/repository-design.md)
+- [Why GitHub for Farm Management](./explanation/why-github.md)
+
+---
+
+## Quick Navigation
+
+| I want to... | Go to... |
+|--------------|----------|
+| Learn how to use this repository | [Getting Started Tutorial](./tutorials/getting-started.md) |
+| Complete a specific task | [How-To Guides](./how-to/) |
+| Look up a term or data field | [Reference Section](./reference/) |
+| Understand farm workflows | [Explanation Section](./explanation/) |
+| See farm data | [Main Repository](../) |
+
+---
+
+## Farm Sections
+
+The repository organizes farm records into four main sections:
+
+- **[crops/](../crops/)** — Planting schedules, crop records, and soil data
+- **[livestock/](../livestock/)** — Health records, feeding schedules, and vet logs
+- **[equipment/](../equipment/)** — Maintenance logs, safety inspections, and inventory
+- **[compliance/](../compliance/)** — Grant tracking and certifications
+
+Each section has its own README with specific documentation.
+
+---
+
+## Contributing to Documentation
+
+Found something unclear or missing? See our [Contributing Guide](../CONTRIBUTING.md) to suggest improvements. Documentation improvements follow the same pull request process as any other contribution.
+
+---
+
+**About Sunny Acres Farm**
+
+This is a 320-acre diversified operation in the Midwest. We grow corn, soybeans, wheat, and alfalfa, and raise beef cattle, dairy cows, sheep, and horses.
+
+*This is a demo repository for GitHub training. All data is fictional.*