ai-cfia / dev-rel-docs

Developer Relations Documentation
MIT License
2 stars 0 forks source link

Documentation Request: Environment Configuration Guidelines #103

Open CFIALeronB opened 5 months ago

CFIALeronB commented 5 months ago

Issue Description

We currently have multiple environment configuration files (environment.ts, environment.staging.ts, and environment.prod.ts) to manage our application settings across different deployment stages. However, it seems that there's no centralized documentation describing the usage, purpose, and selection process of these environment files. This can lead to confusion and inconsistency across the team, especially for new members.

Suggested Documentation Additions

To address this, I propose we add a new section to our existing documentation (or README.md) covering the following points:

  1. Overview of Environment Files:

    • Briefly describe the purpose of each environment file (environment.ts, environment.staging.ts, environment.prod.ts).
  2. Environment Selection Process:

    • Explain how the application determines which environment file to use, primarily focusing on the NODE_ENV environment variable.
  3. Key Features and Benefits:

    • Highlight the benefits of having separate environment files, such as tailored configurations for different deployment stages and consistency across projects.
  4. Basic Usage Guidelines:

    • Provide a general guide on how to use these environment files within the project, without going into too much detail or specific code examples.