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

Feature Request: Adding Documentation for Code Tours #916

Open
IITI-tushar opened this issue Dec 18, 2024 · 0 comments
Open

Feature Request: Adding Documentation for Code Tours #916

IITI-tushar opened this issue Dec 18, 2024 · 0 comments

Comments

@IITI-tushar
Copy link

IITI-tushar commented Dec 18, 2024

Is your feature request related to a problem? Please describe.
Understanding the Rocket.Chat codebase, being a large and complex project, is a significant challenge for new contributors. It can be difficult to figure out which folders or files to explore when trying to tackle an issue. This complexity makes the onboarding process slower and more frustrating for contributors.

Describe the solution you'd like
I propose adding a new section to the Developer Docs website dedicated to a "Code Tour." If adding it directly to the website(https://developer.rocket.chat) is not feasible, we could create a Tours.md file in the repository.

The proposed documentation will:

Provide an overview of the project structure, highlighting key directories and files.
Include interactive guidance using tools like the CodeTour VS Code extension to visually map out the codebase.
Make it easier for contributors to navigate the project efficiently and contribute effectively.

Describe alternatives you've considered

If adding it directly to the website is not feasible, we could create a Tours.md file in the repository.
Creating an external guide (e.g., a GitHub Wiki), but this would fragment the information and is harder to maintain.
Relying on live mentoring or issue-based guidance, but this is not scalable and depends on the availability of maintainers or experienced contributors.
Additional context

I was inspired by the GSoC CodeTour project, which demonstrated how effective code tours are for understanding complex codebases. By introducing a Tours.md file or adding a section on the Developer Docs website, we can improve the experience for contributors and onboard new developers faster.

image
image
image

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

No branches or pull requests

1 participant