Feature Request: Add a Setup Guide for Local Development
Summary
While the current README provides a clear overview of the project's structure and its components, it lacks specific instructions for setting up the project for local development. This can be a barrier for new contributors looking to understand and contribute to the project easily.
Proposed Changes
I suggest adding a section to the README that includes:
- Prerequisites (like required software, dependencies, etc.)
- Step-by-step instructions on how to clone the repo and set up a local development environment
- Guidance on how to run each component (ansible, local-s3, logs-proxy, metrics, tasks) locally for testing purposes
Benefits
Providing clear setup instructions will help onboard new contributors faster and improve the overall contribution process. It will also reduce the time spent troubleshooting setup issues, allowing contributors to focus on actual development.
This repository isn't too interesting for external contributors to be honest. Each directory does have a README.md already. If you want to run a CI-ish environment locally, have a look at tasks/README.md and possibly ansible/localvm/README.md.
metrics/README.md also has docs for local deployment.
What in particular did you try to do?