WrenAI icon indicating copy to clipboard operation
WrenAI copied to clipboard

Enhance Environment Configuration Files with Clarity and Documentation

Open UTSAVS26 opened this issue 1 year ago • 4 comments

This PR improves the clarity, formatting, and documentation of environment configuration files (.env.example, .env.ai.example, and CONTRIBUTING.md). These changes aim to make it easier for contributors and developers to understand and modify the configuration settings. Below is a summary of the changes:


1. Updated .env.example

  • Added detailed comments to clarify the purpose of each variable.
  • Grouped variables logically into sections like Service Ports, LLM Settings, Version Information, etc.
  • Improved the organization and readability of settings to help users easily identify and update necessary values.
  • Ensured consistency in variable names and descriptions.

2. Updated .env.ai.example

  • Enhanced comments and formatting for each section, including LLM (Language Learning Model), Embedder, Document Store, and Langfuse Integration.
  • Clarified the purpose of key variables like API keys, models, and service endpoints.
  • Provided explanations for embedding models and LLM configurations, improving the documentation for both OpenAI and Azure OpenAI settings.

3. Updated CONTRIBUTING.md

  • Corrected grammar, typos, and language consistency.
  • Added clarity to instructions on contributing to different services, including the use of environment variables and Docker Compose setup.
  • Improved the professional tone and readability of the document to align with the project's goals of creating a welcoming and informative space for contributors.

UTSAVS26 avatar Oct 19 '24 06:10 UTSAVS26

@UTSAVS26 thanks for contribution, we'll review it asap

cyyeh avatar Oct 24 '24 00:10 cyyeh

@UTSAVS26 thanks for contribution, we'll review it asap

Thank you.

UTSAVS26 avatar Oct 24 '24 02:10 UTSAVS26

@UTSAVS26 could you remove updates from .env.ai.example or .env.example? since in the near future, we'll release a new design that replaces old version. so it'll be conflict then if I merge this to the main branch and makes no sense

cyyeh avatar Oct 24 '24 03:10 cyyeh

@UTSAVS26 could you remove updates from .env.ai.example or .env.example? since in the near future, we'll release a new design that replaces old version. so it'll be conflict then if I merge this to the main branch and makes no sense

Sure I will remove them and update you regarding it.

UTSAVS26 avatar Oct 24 '24 03:10 UTSAVS26

Outdated, so I will close it now

cyyeh avatar Mar 14 '25 20:03 cyyeh