As part of the ongoing effort to enhance the user experience and make the project more accessible to new contributors, there is a need to improve the onboarding documentation. The current documentation lacks some key details on setting up the project environment and contributing effectively.
Problem:
New contributors often struggle with the initial setup due to missing or outdated instructions.
There is no clear step-by-step guide for configuring the development environment, leading to confusion.
Existing documentation does not cover best practices for submitting contributions (e.g., creating issues, pull requests).
Proposed Solution:
Update the README.md to include a comprehensive step-by-step guide for setting up the project locally, including dependencies, configuration, and troubleshooting.
Add a CONTRIBUTING.md file to outline the process for submitting issues, pull requests, and adhering to the project's coding standards.
Ensure the documentation is up-to-date with any recent changes in the codebase or setup requirements.
Optionally, add a Quick Start section to guide contributors in getting started as quickly as possible.
Additional Context:
Consider using existing examples from similar projects for onboarding guidelines.
Ensure the new documentation is clear, concise, and accessible to non-developers as well.
Acceptance Criteria:
The README.md contains an updated setup guide.
A CONTRIBUTING.md file is created, providing guidance for contributing to the project.
Any outdated information in the documentation is revised or removed.
Feedback from at least one new contributor confirms that the onboarding process is now clearer.
Feel free to ask for any clarification or suggestions on improving the documentation structure!
Issue Title: Improve Project Onboarding Documentation
Issue Description:
As part of the ongoing effort to enhance the user experience and make the project more accessible to new contributors, there is a need to improve the onboarding documentation. The current documentation lacks some key details on setting up the project environment and contributing effectively.
Problem:
Existing documentation does not cover best practices for submitting contributions (e.g., creating issues, pull requests).
Proposed Solution:
Optionally, add a Quick Start section to guide contributors in getting started as quickly as possible.
Additional Context:
Feel free to ask for any clarification or suggestions on improving the documentation structure!
Below is the Link to the full article post: https://medium.com/@electronudeme/a-beginners-guide-to-contributing-to-open-source-as-a-technical-writer-e43a1bb96c6c