Skip to content

Improve Onboarding with Generated System Diagrams #2356

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

Closed
wants to merge 2 commits into from

Conversation

ivanmilevtues
Copy link

This PR adds auto-generated high-level diagrams and component-level documentation using CodeBoarding, aimed at improving developer onboarding by making it easier to get to know the codebase and lowering the barrier to contribution.

We would love to hear what you think about the generated diagrams — feedback is more than welcome. If you are interested in using CodeBoarding for other projects or want to get in touch, feel free to reach out to me.

@aclark4life
Copy link
Contributor

Thank you @ivanmilevtues ! We will discuss

@ShaneHarvey
Copy link
Member

Thanks but we are not going to merge this because it adds little value and too much maintenance cost. People who want AI content like this should just ask an AI model directly.

@ivanmilevtues
Copy link
Author

Thank you for the answers @aclark4life and @ShaneHarvey!

Just to touch on the maintainance point, we've just added a GitHub action which is free for public repos and it will maintain the documents automatically!

Further the way we generate this is based on Static Analysis and LLMs. BUt I understand your point.

Wish you all the best!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants