This directory contains comprehensive documentation for SWE-bench.
- index.md: Main documentation landing page with overview and quick links
- installation.md: Complete installation instructions
- faq.md: Frequently asked questions
- guides/: Step-by-step guides for common tasks
- quickstart.md: Getting started with SWE-bench
- evaluation.md: How to evaluate models
- docker_setup.md: Detailed Docker configuration guide
- datasets.md: Information about available datasets
- create_rag_datasets.md: How to create custom RAG datasets
- reference/: Detailed API and technical references
- harness/: Documentation for the evaluation harness
- inference/: Documentation for model inference
- versioning.md: Explanation of the versioning system
- api/: API documentation (reserved for future use)
When updating the documentation:
- Keep the structure consistent
- Ensure cross-references between documents are correct
- Update the main index.md when adding new sections
- Test code examples to ensure they work properly
When contributing to the documentation:
- Follow the existing style and formatting
- Use Markdown for all documents
- Include practical examples when explaining features
- Cross-reference related documentation sections
Future documentation improvements:
- Add more code examples and tutorials
- Create video tutorials for complex tasks
- Develop auto-generated API documentation
- Expand troubleshooting guides with common issues