Skip to content

Comments

chore: update repository documentation#98

Merged
liamnwhite1 merged 10 commits intodevelopfrom
chore/update-documentation
Dec 9, 2025
Merged

chore: update repository documentation#98
liamnwhite1 merged 10 commits intodevelopfrom
chore/update-documentation

Conversation

@liamnwhite1
Copy link
Collaborator

depends: #97

This pull request introduces major improvements to project documentation, issue tracking, and contribution workflow. The changes standardize templates for issues and pull requests, add a comprehensive contribution guide, and overhaul the README.md for clarity and onboarding. Additionally, a new Doxygen layout is provided for better API documentation structure.

Documentation & Onboarding Enhancements

  • Overhauled README.md to provide a clear project overview, feature list, support channels, documentation links, onboarding instructions, and contributor acknowledgments. Improved formatting and updated images.
  • Added a detailed CONTRIBUTING.md guide outlining workflow, branch naming, commit conventions, PR process, style, formatting, and documentation expectations for maintainers and contributors.
  • Added DoxygenLayout.xml to define the navigation and layout for API documentation, improving the structure and usability of generated docs.

Issue & PR Template Standardization

  • Added new standardized issue templates: bug_report.md for bugs and development_task.md for tasks/feature requests, ensuring consistent and complete issue submissions. [1] [2]
  • Removed the old custom issue template (custom.md) to avoid confusion and enforce use of the new standardized templates.
  • Added a comprehensive pull request template (pull_request_template.md) to guide contributors in documenting changes, context, testing, and review notes.

Assets and Miscellaneous

  • Added a new project logo (slicer-2_logo.png) to the assets directory for branding and documentation use.

These updates make it easier for new contributors to get started, improve the quality of reported issues and submitted PRs, and enhance the overall maintainability and professionalism of the project.

- style guide for project coding standards
- formatting guidelines using clang-format
- Conventional Commits guidelines for commit message standards
- Doxygen documentation guidelines
- Conventional Branch Naming Guide for clarity and consistency
- pull request guidelines
- issue submission guide
- Slicer2.gif
- GPU acceleration documents
- Abstract Slicing.pdf
- Generating Master Configuration.pdf
- todo.txt
- custom.md
@liamnwhite1 liamnwhite1 marked this pull request as draft November 21, 2025 18:30
@liamnwhite1 liamnwhite1 force-pushed the chore/update-documentation branch from 204a104 to 1960bd1 Compare November 21, 2025 19:49
@liamnwhite1 liamnwhite1 marked this pull request as ready for review November 24, 2025 11:10
@liamnwhite1 liamnwhite1 self-assigned this Nov 24, 2025
@liamnwhite1 liamnwhite1 merged commit 6ca35ae into develop Dec 9, 2025
4 checks passed
@liamnwhite1 liamnwhite1 deleted the chore/update-documentation branch December 9, 2025 16:14
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