Skip to content

docs: improve installation guide and restructure documentation config…#2430

Closed
mathsvisualization wants to merge 1 commit into3b1b:masterfrom
mathsvisualization:refactor/docs-structure
Closed

docs: improve installation guide and restructure documentation config…#2430
mathsvisualization wants to merge 1 commit into3b1b:masterfrom
mathsvisualization:refactor/docs-structure

Conversation

@mathsvisualization
Copy link
Contributor

Motivation

The current documentation had some structural inconsistencies and areas where
installation and configuration steps were not clearly explained for new users.
This PR improves clarity, organization, and overall readability of the docs.

The goal was to:

  • Make installation steps easier to follow (especially for beginners)
  • Improve the explanation of the project structure
  • Clarify configuration-related sections
  • Ensure consistent heading hierarchy and formatting across pages

These changes aim to improve the onboarding experience and make the documentation
more structured and maintainable.


Proposed Changes

  • Updated the Installation section with clearer, step-by-step instructions
  • Improved explanation of the project structure
  • Refactored and reorganized the configuration documentation
  • Reorganized headings and subsections for better logical flow
  • Fixed formatting issues and minor inconsistencies
  • Cleaned up redundant or unclear phrasing

Test

  • Built the documentation locally using:
make html

…uration

- Updated Installation section with clearer step-by-step instructions
- Improved project structure explanation
- Refactored configuration documentation for better clarity
- Reorganized headings and subsections for consistency
- Fixed formatting and minor inconsistencies
Copy link
Contributor Author

@mathsvisualization mathsvisualization left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi 👋

This PR improves the documentation structure and installation guide.
I have reorganized sections for better clarity and updated configuration explanations.

Would appreciate your review and feedback.
Thank you!

@mathsvisualization mathsvisualization deleted the refactor/docs-structure branch February 17, 2026 02:05
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.

1 participant