openspp-modules icon indicating copy to clipboard operation
openspp-modules copied to clipboard

Create Developer Setup Scripts for OpenSPP

Open jeremi opened this issue 10 months ago • 4 comments

Create Developer Setup Scripts for OpenSPP

Description

Setting up a development environment for OpenSPP can be time-consuming and error-prone. Automated setup scripts would greatly reduce the barrier to entry for new contributors and ensure consistent development environments across the team. These scripts should be well-documented and integrated into the existing OpenSPP documentation.

Objective

Develop scripts that:

  1. Automate the setup of a complete OpenSPP development environment
  2. Work across different operating systems (Linux, macOS, potentially Windows)
  3. Include all necessary dependencies
  4. Configure development tools and settings
  5. Are thoroughly documented in the OpenSPP documentation repository

Tasks

  • Review existing development setup documentation in the OpenSPP repository
  • Create a bash script for Linux/macOS that installs all prerequisites
  • Document each step in the script with comments
  • Include database setup and configuration
  • Add options for different development configurations
  • Create a verification step to ensure the environment is correctly set up
  • Add commands to initialize test data
  • Include instructions for updating the development environment
  • Create documentation for the scripts following the OpenSPP documentation structure
  • Prepare a pull request to add the scripts and documentation to the appropriate repositories

Expected Outputs

  • Well-commented setup scripts (bash for Linux/macOS)
  • Documentation on how to use the scripts in the OpenSPP documentation format
  • Verification mechanism to confirm successful setup
  • Instructions for troubleshooting common setup issues
  • Pull request to the OpenSPP documentation repository for the documentation
  • Pull request to the appropriate OpenSPP repository for the scripts

Good First Tasks for the Sprint

  • Review existing documentation related to development environment setup
  • Identify all requirements for a development environment
  • Create a basic script that installs dependencies
  • Add database setup steps
  • Test the script on a clean system
  • Document common issues encountered during setup
  • Create documentation draft following OpenSPP's documentation style

Resources

Labels

documentation, good-first-issue, beginner-friendly, enhancement, size:M

Priority

High

Size

Medium (May require follow-up after sprint)

jeremi avatar Mar 02 '25 03:03 jeremi

I would like to do this

shanjare2002 avatar Mar 22 '25 00:03 shanjare2002

Hello,

Is this work item completed? If not i'd like to work on this.

shreenidhi11 avatar Jun 02 '25 22:06 shreenidhi11

Is it still up?

digvijay-y avatar Jul 30 '25 06:07 digvijay-y

I would like to do this

rohitkrishna03 avatar Sep 11 '25 16:09 rohitkrishna03