jargonsdev / jargons.dev

A community-driven dictionary that simplifies software, engineering and tech terms for all levels.
https://jargons.dev
GNU General Public License v2.0
30 stars 12 forks source link

[FEATURE]: Documentation Structure and Clarity Improvements #107

Open AyendiSimeon1 opened 1 week ago

AyendiSimeon1 commented 1 week ago

Is this a unique feature/idea?

Is your feature request related to a problem/unavailable functionality? Please describe.

The current documentation lacks clear structure and essential information, making it difficult for new contributors to get started. Specifically:

The hierarchy and organization are unclear, making information hard to find Setup instructions lack context and proper error handling guidance Contribution workflows are not thoroughly explained Missing important sections like community engagement and troubleshooting Inconsistent formatting and markdown usage throughout

These issues create friction for new contributors and may discourage participation in the project.

Proposed Solution

Restructure the documentation to follow a clear, hierarchical format with comprehensive information

Improved Structure

Clear main sections with proper heading hierarchy Logical flow from introduction to advanced topics Consistent formatting and spacing

Enhanced Content

Detailed feature overview Comprehensive setup instructions with troubleshooting Clear contribution guidelines with step-by-step processes Added community and support sections

Technical Improvements

Proper markdown formatting Working links to all referenced resources Code block syntax highlighting Clear setup script documentation

Screenshots

No response

Do you want to work on this issue?

Yes

If "yes" to above, please explain how you would technically implement this

Update Main README.md

Create Additional Documentation

babblebey commented 1 week ago

Considering the PR that was closed for this issue, It looks as though this issue sorta overhauls the entire documentation.

This isn't the kind of approach we'd want to take in attempt to improve the documentation, we prefer a section-by-section improvement instead.

With the section-by-section improvement, we can be sure that changes are made well overtime collecting the view of more contributors.