-
Notifications
You must be signed in to change notification settings - Fork 342
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: Modification of README.md file(Design), & Creation of dedicated Contributing.md file and LICENSE. #311
Comments
Thank you for creating this issue! 🎉 Your issue will soon be reviewed by either the PA or a mentor. Please note that Level 1 is temporary and can be changed during the review. In the meantime, please make sure to provide all the necessary details and context. If you have any questions or additional information, feel free to add them here. Your contributions are highly appreciated! 😊 You can also check our CONTRIBUTING.md for guidelines on contributing to this project. |
Thanks for creating the issue in BuddyTrail!
We're excited to see your contribution as part of GSSOC Extended Edition 2024 and Hacktoberfest! 🎉 |
@PriyaGhosal I also noticed while working that you don't have a LICENSE for your project. Do you want me to add it to my issue and work on it since I am working on updating the documentation of the project? Since this is an open-source project, it should have a LICENSE in it. |
@PriyaGhosal Please do let me know. |
@PriyaGhosal wanted to update you regarding the work. I have successfully automated the process of adding the contributors in your README.md file. You no more have to manually add the Contributors(reflecting poor documentation practice). |
This will update automatically! |
@PriyaGhosal Please update me regarding this so that I can either add it and open a PR. |
I just noticed this message. Sadly there was not such file in the project before. But after I merge it, please update this and provide a redirect to it. |
@rajdeepchakraborty-rc Sorry for the inconvenience caused You can surely add license .. Create new pr I will surely merge it ......You have done great job :) |
@PriyaGhosal I have not yet created the PR was waiting for you response |
I am done with most of the work. Just adding the LICENSE is left. Will add that and open a PR and let you know. |
Thanks for the appreciation. |
@rajdeepchakraborty-rc You need not to ask me .... Any contributor is free to raise issue and create PR ..... Thank You for your Patience |
Please try to visit the issues once in a while as Contributors might wanna ask you doubts or share any feedback with you. |
Since I am working in your project, I must ethically let you know about any changes I am making. I was just doing that. Thanks for your reply. |
@PriyaGhosal Please let me know once you are done merging because I am constantly getting conflicts. I will resolve the conflicts once you are done merging PRs. |
@PriyaGhosal Also Please do not add Contributors manually anymore. I don't know who is adding them. Please tell that person to stop as I have automated the process. The entire reason I worked for so long was so that you don't have to keep track manually of the contributors anymore and rather focus on spending time on issues and PR reviews. |
Hello @rajdeepchakraborty-rc! Your issue #311 has been closed. Thank you for your contribution! |
@PriyaGhosal Please update the level to level2 |
What's wrong with the existing documentation
Proposed Solution
1. Modifications in README.md file
1) Add animated line separators
This will make the README.md file look more attractive and engaging for the Users and Contributors
2) Modifiy the Contributors section.
I noticed that you are manually adding the contributors to your project. I want to try and automate the process to reduce your workload.
NOTE: However, let me mention that the looks will change(screenshot attached below).
3) Add a Team section
This will help the Contributors know about the Project Admin and who to contact if they face any issues.
2. Add a dedicated Contributing.md
A dedicated file for contributors to refer to and understand where to begin with. Merging the README.md with the Contributing section reflects poor documentation style. I will provide a brief idea about the contribution in the README.md file and provide a redirect to the newly made Contributing.md file for contributors to refer to.
I would also add a redirect to Contributing.md from README.md
3. Add MIT LICENSE
The presence of a LICENSE file explicitly states the terms under which the code can be used, modified, and shared. If a project does not have a LICENSE file, it implies that the author has not granted any rights to others, and legally, no one has permission to use, distribute, or modify the code.
So, adding a LICENSE file is a best practice for open-source projects.
I would like to work on the issues so that I can contribute to making the repository more accessible and friendly for other Contributors.
Please assign this issue to me under level3, gssoc-ext and hacktoberfest-accepted(if available) labels.
Add ScreenShots
1. Modifications in README.md file
1) Add animated line separators
2) Modifiy the Contributors section.
This is taking up a lot of space and resulting in unnecessary scrolling in the README.md file.
This will give a neat outlook and also enhance the readability of the README.md file.
3) Add a Team section
2. Add a dedicated Contributing.md
Reference file image:
3. Add MIT LICENSE
Record
The text was updated successfully, but these errors were encountered: