Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Doc: update the envfile #6246

Closed
2 tasks done
satyampsoni opened this issue Jan 2, 2025 · 0 comments · Fixed by #6254
Closed
2 tasks done

Doc: update the envfile #6246

satyampsoni opened this issue Jan 2, 2025 · 0 comments · Fixed by #6254
Assignees
Labels
documentation Improvements or additions to documentation triage-accepted Issue is accepted by the organisation to be worked on.

Comments

@satyampsoni
Copy link
Contributor

satyampsoni commented Jan 2, 2025

💭 Description

New developers onboarding the project may face challenges configuring environment variables, especially if these details are not clearly documented. To streamline the setup process, we propose adding a .env file template to the repository.

Proposed Solution

  • Create a .env.example file in the root of the project.
  • Include all necessary environment variables required to run the application.
  • Add comments for each variable, explaining its purpose and possible values.
  • Use placeholder values (e.g., YOUR_API_KEY, localhost, etc.) that do not expose sensitive information.
  • Update the documentation to include a step explaining how to copy the template and set up the .env file.

Benefits

  • Simplifies onboarding for new contributors.
  • Reduces setup time and errors due to missing or misconfigured environment variables.
  • Promotes best practices by encouraging the use of .env files for configuration.

Tasks

  • Create the .env.example file.
  • Populate it with placeholders for all required variables.
  • Update relevant sections of the documentation.

Additional Context

If there are any existing environment variables or configurations that need to be included, please share them in the comments.

👀 Have you spent some time to check if this issue has been raised before?

  • I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

@satyampsoni satyampsoni added documentation Improvements or additions to documentation needs-triage Issue is not approved or ready-to-work on labels Jan 2, 2025
@satyampsoni satyampsoni added triage-accepted Issue is accepted by the organisation to be worked on. and removed needs-triage Issue is not approved or ready-to-work on labels Jan 2, 2025
@satyampsoni satyampsoni changed the title Doc: add a .env file to the repo Doc: update the envfile Jan 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation triage-accepted Issue is accepted by the organisation to be worked on.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants