jatiinyadav / Crew-Connect

Enhance your discussions with a group chat feature, providing a collaborative environment for more dynamic conversations.
MIT License
8 stars 18 forks source link

📝[Docs]: Add Table of Contents to README file. #50

Closed GUNJESH843 closed 1 month ago

GUNJESH843 commented 1 month ago

What Docs changes are you proposing? I am proposing the addition of a Table of Contents to the README file. The Table of Contents will include links to key sections such as Usage, Screenshots, Features, Setup Instructions, Contributing, Documentation, Join Us, and Our Contributors.

Why do the Docs need this improvement? What is the motivation for this change? How will this change benefit the community? The documentation will benefit from this improvement by providing users with an easy-to-navigate structure. This change will enhance the user experience by allowing users to quickly locate and access relevant sections of the README. The motivation behind this change is to improve the overall readability and usability of the documentation, making it more professional and user-friendly.

Describe the solution you'd like The solution involves inserting a Table of Contents at the beginning of the README file. This Table of Contents will contain anchor links to the following sections

Describe alternatives you've considered An alternative approach considered was to include a sidebar or a collapsible menu for navigation within the README. However, these methods may not be as straightforward to implement in a Markdown file and might reduce the simplicity and compatibility of the document across different viewers.

Additional context Adding a Table of Contents will make the documentation more organized and accessible, especially for first-time users. Below is an example of how the Table of Contents will look. Screenshot 2024-06-06 213549

github-actions[bot] commented 1 month ago

Hi there! Thanks for opening this issue. We appreciate your contribution to this open-source project. We aim to respond or assign your issue as soon as possible.

GUNJESH843 commented 1 month ago

@jatiinyadav can you assign this issue to me.

I AM A GSSOC CONTRIBUTER

Thankyou.

jatiinyadav commented 1 month ago

Hi @GUNJESH843, Make sure you add Table of Contents in all the md files, not specifically README.md

GUNJESH843 commented 1 month ago

@jatiinyadav sure I will be adding a Table of Contents in all the MD files, right now I have completed it for the README.md file and have opened a PR.

I request you to merge the PR.

Till then I will continue to add Content Tables to all md files.

Thankyou

jatiinyadav commented 1 month ago

Hi @GUNJESH843, Updating only README.md file will not be counted as LEVEL 1 issue. Please update all the MD files otherwise I have to mark the ticket as LEVEL 0.

There are strict guidelines from the GSSOC Program Managers.

GUNJESH843 commented 1 month ago

@jatiinyadav sure

GUNJESH843 commented 1 month ago

@jatiinyadav Hey, I have worked on the .md files mentioned by you and have added the table of contents to 4 files

  1. README.md
  2. CODE_OF_CONDUCT.md
  3. CONTRIBUTING.md
  4. INSTALLATION.md

I request to label this as >= level 2, this would help motivate me to work more on such issues,

Thank you