You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@age.apache.org by "markgomer (via GitHub)" <gi...@apache.org> on 2023/08/01 18:33:12 UTC
[GitHub] [age] markgomer opened a new issue, #1120: Proposal: Create a Comprehensive Developer's Manual
markgomer opened a new issue, #1120:
URL: https://github.com/apache/age/issues/1120
**Is your feature request related to a problem? Please describe.**
The onboarding process for new contributors to the Apache AGE project is challenging due to a lack of comprehensive documentation about the codebase, standards, and procedures. This makes it difficult for new developers to understand how they can best contribute to the project. Furthermore, the absence of a standard guide may lead to inconsistencies in code and practices across the project.
**Describe the solution you'd like**
I propose that we create a comprehensive Developer's Manual for the Apache AGE project. This document should provide:
1. An overview of the project structure and codebase to help newcomers understand the system quickly.
2. Our coding and documentation standards, best practices, and conventions to ensure consistency across the project.
3. Step-by-step procedures for common tasks like submitting pull requests, reporting bugs, or proposing new features.
4. Information about the project's vision, goals, and roadmap to ensure that all contributors are aligned in their efforts.
**Describe alternatives you've considered**
An alternative solution could be creating separate documents for each of the points mentioned above. However, having all the information in one comprehensive Developer's Manual would provide a central source of truth and would be more efficient for both new and existing contributors.
**Additional context**
Creating a comprehensive Developer's Manual would not only ease the onboarding process for new contributors but also enhance collaboration among team members. It would provide a shared understanding of the project and its goals, making the development process smoother and more efficient. As the project grows, this manual will be an invaluable resource to ensure consistency and quality in our collaborative efforts.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [age] MatheusFarias03 commented on issue #1120: Proposal: Create a Comprehensive Developer's Manual
Posted by "MatheusFarias03 (via GitHub)" <gi...@apache.org>.
MatheusFarias03 commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-1675141618
I think that, for now, we can add to the documentation some of the functions that are missing. But it would really help to have a developer's manual. For that, we might need to do some reverse engineering, it would probably be best if someone with more knowledge on AGE could guide us through on which files to look for and in which it would be best to do that, so we can see how exactly things work.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [age] TalhaMunir-JD commented on issue #1120: Proposal: Create a Comprehensive Developer's Manual
Posted by "TalhaMunir-JD (via GitHub)" <gi...@apache.org>.
TalhaMunir-JD commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-1674437743
This would be a great addition as it will reduce most of the confusion and accelerate the new intern's ability to contribute effectively. It will also lead to better code quality and easier maintenance.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [age] carlasanches commented on issue #1120: Proposal: Create a Comprehensive Developer's Manual
Posted by "carlasanches (via GitHub)" <gi...@apache.org>.
carlasanches commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-1662940722
I support this proposal and would like to contribute if it becomes a project. Another suggestion I've seen in other open-source projects is to create a "good first issue" category. This helps new contributors find issues easier to contribute to when first introduced to the project and still add value.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Proposal: Create a Comprehensive Developer's Manual [age]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-2105397336
This issue is stale because it has been open 45 days with no activity. Remove "Abondoned" label or comment or this will be closed in 7 days.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [age] M4rcxs commented on issue #1120: Proposal: Create a Comprehensive Developer's Manual
Posted by "M4rcxs (via GitHub)" <gi...@apache.org>.
M4rcxs commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-1672359429
It would be really helpful if this proposal goes ahead! If there are other interns to guide the newest ones, using techniques like pair programming and explaining how to contribute, that would also be good!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Proposal: Create a Comprehensive Developer's Manual [age]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] closed issue #1120: Proposal: Create a Comprehensive Developer's Manual
URL: https://github.com/apache/age/issues/1120
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [age] rafsun42 commented on issue #1120: Proposal: Create a Comprehensive Developer's Manual
Posted by "rafsun42 (via GitHub)" <gi...@apache.org>.
rafsun42 commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-1673510483
For (2), there is a web page https://age.apache.org/contribution/guide. I will add setting up clangformat as well.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Proposal: Create a Comprehensive Developer's Manual [age]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-2251605584
This issue was closed because it has been stalled for further 14 days with no activity.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Proposal: Create a Comprehensive Developer's Manual [age]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-2221743615
This issue is stale because it has been open 60 days with no activity. Remove "Abondoned" label or comment or this will be closed in 14 days.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [age] titoausten commented on issue #1120: Proposal: Create a Comprehensive Developer's Manual
Posted by "titoausten (via GitHub)" <gi...@apache.org>.
titoausten commented on issue #1120:
URL: https://github.com/apache/age/issues/1120#issuecomment-1663055578
This will help alot.
Unfortunately, I made some PRs that wasn't considered because of lack of such info. If there are clear details about contribution, It's going to be a great foundation for new contributors.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@age.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org