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

Doc installation #901

Merged
merged 7 commits into from
Jul 11, 2023
Merged

Doc installation #901

merged 7 commits into from
Jul 11, 2023

Conversation

phlptp
Copy link
Collaborator

@phlptp phlptp commented Jun 29, 2023

This PR includes updates from #774 and #613.
It updates the readme and docbook with some additional installation instructions.

@phlptp phlptp added the docs Add/update documentation label Jun 29, 2023
@phlptp phlptp requested a review from henryiii June 29, 2023 16:38
@phlptp
Copy link
Collaborator Author

phlptp commented Jun 29, 2023

@henryiii did we want to reduce the installation section of the readme and include some of the stuff that is in that section in the docbook?

@codecov
Copy link

codecov bot commented Jun 29, 2023

Codecov Report

Patch and project coverage have no change.

Comparison is base (985a19f) 99.46% compared to head (d590e81) 99.46%.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #901   +/-   ##
=======================================
  Coverage   99.46%   99.46%           
=======================================
  Files          18       18           
  Lines        4099     4099           
=======================================
  Hits         4077     4077           
  Misses         22       22           

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

@henryiii
Copy link
Collaborator

henryiii commented Jun 29, 2023

We can, we could just show the main way + list the others shown in the gitbook.

FYI, I'm going to need to migrate off of GitBook in the near future, it's pretty well past EoL. Maybe a JupyterBook, or a Hugo/jekell/sphinx/mkdocs solution would work, not sure yet what would be best.

@phlptp
Copy link
Collaborator Author

phlptp commented Jun 29, 2023

we use sphinx and readthedocs in most of my other projects. That handles markdown, though I would imagine any changes would require some level of restructuring.

@henryiii henryiii merged commit ccf141c into CLIUtils:main Jul 11, 2023
45 checks passed
@henryiii henryiii deleted the doc_installation branch July 11, 2023 12:43
@github-actions github-actions bot added the needs changelog Hasn't been added to the changelog yet label Jul 11, 2023
FetchContent_MakeAvailable(cli11)

# And now you can use it
add_subdirectory(${cli11_proj_SOURCE_DIR} ${cli11_proj_SOURCE_DIR}/build)
Copy link

Choose a reason for hiding this comment

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

Is there any reason the additional add_subdirectory call and the SOURCE_DIR parameter have been added here compared to the more idiomatic version that was in the readme before?

The second one just bit me on a CI system with caching for the default FetchContent directories set up.

I can prepare a small PR but I wanted to ask first since it looks like it has been deliberately changed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Add/update documentation needs changelog Hasn't been added to the changelog yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants