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

docs: add book structure and basic documentation #51

Conversation

salasberryfin
Copy link
Contributor

Description

This PR adds basic documentation on how to install the provider. The docs are structured to support the creation of a book in line with most upstream CAPI projects (for example CAPG).

The documentation is a work in progress and this PR is only a basic scaffolding to build a more complete reference on top of it.

docs/book/src/topics/prerequisites.md Show resolved Hide resolved
@@ -0,0 +1,12 @@
# Summary
Copy link
Contributor

Choose a reason for hiding this comment

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

We can later explore making summary autogenerated, as this may be outdated with manual edits in the future.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sounds good. When we work on publishing this as a book, we'll have to add build scripts (upstream uses Makefile) and we can also work on having an automatically updated summary.

@Danil-Grigorev
Copy link
Contributor

Danil-Grigorev commented May 29, 2024

I think this should cover #20 as well, thanks Carlos for working on it, LGTM

Signed-off-by: Carlos Salas <carlos.salas@suse.com>
@salasberryfin salasberryfin force-pushed the create-initial-book-structure branch from b53a6a3 to 44d8693 Compare May 29, 2024 14:49
@salasberryfin
Copy link
Contributor Author

Thanks for the review @Danil-Grigorev. I updated the PR with a reference to just in the prerequisites section + updated the content of the docs/README.md including the existing information from the project's README file + some extra references to internal documentation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants