optimus icon indicating copy to clipboard operation
optimus copied to clipboard

Add Guide for Development Setup

Open irainia opened this issue 2 years ago • 2 comments

Background

If we look at the current documentation, like README.md (latest commit here) or the blog documentation, there is no guide being provided to setup local for development. A little example, what needs to be prepared in the local environment to do test (unit test and integration test)? Another, what database and which version should we prepare? If no guide or the guide is not clear to set up for local testing, then little chance any developers will use it to test locally. And this could hinder adoption.

Proposal

We need to have a comprehensive guide and documentation for both developer and the general user. The guide and documentation should include as many details as possible, no matter how small they are. Be it the database and its version, or the scheduler like Airflow, or even what environment variable is needed, how to deploy, how to set up the job, what to prepare for resources, how to monitor the whole system, and more. Everything should be included.

irainia avatar Jun 23 '22 05:06 irainia

Additional considerations that need to be included. We also need to put a glossary for every keyword we use. Another thing to add is a step-by-step guide for each possible activity. For example, in order to deploy job, what to prepare and what to do, and with recommendation and exception would be great, such as how to write project configuration for the deployment.

irainia avatar Aug 29 '22 07:08 irainia

Should be handled as part of #168

sravankorumilli avatar Sep 09 '22 11:09 sravankorumilli