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

Improve Documentation and Fix Bugs #87

Merged
merged 25 commits into from
Sep 11, 2023
Merged

Conversation

AutonomicPerfectionist
Copy link
Contributor

@AutonomicPerfectionist AutonomicPerfectionist commented Jul 14, 2023

Is this pull request associated with an issue(s)?
Fixes #44

Description
This PR improves documentation. It updates the README to include a bit of reasoning behind the project, and includes the intro of the README in the index.rst of the documentation.

Edit
While adding types to the various signatures, multiple bugs were found, such as incorrectly handling CMAKEPP_LANG_DEBUG_MODE and not accounting for re-execution when comparing section IDs. Additionally, the type checking identified areas where we were reconstructing execution unit objects when they already existed.

TODOs

  • Go through rest of documentation and update

Note
Method parameter types have been refined to pointer types, meaning CMakePP/CMakePPLang#106 must be fixed before merging this

Note 2
This PR is getting very large, so I've decided to cut it off for now and finish the other documentation updates and clean up in a subsequent PR

@AutonomicPerfectionist AutonomicPerfectionist linked an issue Jul 14, 2023 that may be closed by this pull request
6 tasks
@AutonomicPerfectionist AutonomicPerfectionist changed the title Improve Documentation Improve Documentation and Fix Bugs Aug 29, 2023
@AutonomicPerfectionist AutonomicPerfectionist marked this pull request as ready for review September 9, 2023 01:40
ryanmrichard
ryanmrichard previously approved these changes Sep 11, 2023
README.rst Outdated Show resolved Hide resolved
@ryanmrichard
Copy link
Contributor

This looks great!!! The only minor suggestion I had was to link from the README to the examples/tutorials.

Co-authored-by: Ryan Richard <[email protected]>
@AutonomicPerfectionist
Copy link
Contributor Author

@ryanmrichard I committed your suggestion, so if everything else looks good feel free to merge

@ryanmrichard
Copy link
Contributor

@ryanmrichard I committed your suggestion, so if everything else looks good feel free to merge

Sounds good. I'll merge it whenever CI passes (at lease I assume it'll pass...).

@ryanmrichard ryanmrichard merged commit 7023a68 into master Sep 11, 2023
6 checks passed
@ryanmrichard ryanmrichard deleted the 44-better-documentation branch September 11, 2023 15:09
@github-actions
Copy link

🚀 [bumpr] Bumped! New version:v0.1.7 Changes:v0.1.6...v0.1.7

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.

Better Documentation
2 participants