cockpituous icon indicating copy to clipboard operation
cockpituous copied to clipboard

Feature Request: Add a Setup Guide for Local Development

Open grasmarcussanti129 opened this issue 5 months ago • 1 comments

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.

grasmarcussanti129 avatar Sep 26 '25 11:09 grasmarcussanti129

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?

martinpitt avatar Sep 26 '25 18:09 martinpitt