# erold.guide

> The open encyclopedia of development guidelines. Best practices for every framework, accessible to humans and AI agents.

erold.guide is an open-source, community-driven collection of development guidelines and best practices. All content is freely available via web interface and JSON API.

## Quick Stats

- 4 guidelines across 3 topics
- Updated daily by community contributors
- MIT Licensed - free to use and reference

## API Access

All guidelines are available programmatically via JSON API. No authentication required.

**Base URL:** https://erold.guide/api/v1

### Key Endpoints

- GET /api/v1/manifest.json - Complete site manifest with all metadata
- GET /api/v1/topics/index.json - List of all topics
- GET /api/v1/topics/{slug}/index.json - Guidelines for a specific topic
- GET /api/v1/guidelines/{topic}/{category}/{slug}.json - Full guideline content

### Example Usage

```bash
# Fetch all topics
curl https://erold.guide/api/v1/topics/index.json

# Fetch Next.js guidelines
curl https://erold.guide/api/v1/topics/nextjs/index.json
```

## Topics

- [erold.guide](https://erold.guide/explore/erold): Meta-guidelines for contributing to erold.guide. Learn how to write, structure, and submit guidelines that help developers and AI agents build better software. (1 guidelines)
- [FastAPI](https://erold.guide/explore/fastapi): A modern, fast web framework for building APIs with Python based on standard Python type hints. High performance, easy to learn, and ready for production. (1 guidelines)
- [Next.js](https://erold.guide/explore/nextjs): The React framework for production. Next.js provides hybrid static and server rendering, TypeScript support, smart bundling, and route pre-fetching. (2 guidelines)

## How to Use This Content

### For AI Agents
1. Fetch /api/v1/manifest.json for complete site overview
2. Use /api/v1/topics/{slug}/index.json to get topic-specific guidelines
3. Retrieve full content via /api/v1/guidelines/{topic}/{category}/{slug}.json

### For Developers
- Browse at https://erold.guide/explore
- Each guideline includes difficulty level, prerequisites, and related content
- Content is structured with clear headings, code examples, and best practices

## Optional

- Full content index: https://erold.guide/llms-full.txt
- API Documentation: https://erold.guide/api
- Contribute: https://erold.guide/contribute
- GitHub: https://github.com/erold-dev/erold.guide