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

Intial documentation refactor #878

Open
wants to merge 13 commits into
base: main
Choose a base branch
from

Conversation

matejmatuska
Copy link
Member

@matejmatuska matejmatuska commented Jul 30, 2024

The documentation is reorganized to adhere to the new hierarchy design and also drops the documentation related to oamg/leapp-repository and related direct references.

Note that some pages/sections might feel a little out of place or miss some content (most notably building-blocks-and-architecture and libraries-and-api), that's expected and these places will be filled in in future patches.

A few typo corrections are also included.

Depends on #854

Copy link

Thank you for contributing to the Leapp project!

Please note that every PR needs to comply with the Leapp Guidelines and must pass all tests in order to be mergeable.
If you want to request a review or rebuild a package in copr, you can use following commands as a comment:

  • review please @oamg/developers to notify leapp developers of the review request
  • /packit copr-build to submit a public copr build using packit

To launch regression testing public members of oamg organization can leave the following comment:

  • /rerun to schedule basic regression tests using this pr build and leapp-repository*master* as artifacts
  • /rerun 42 to schedule basic regression tests using this pr build and leapp-repository*PR42* as artifacts
  • /rerun-sst to schedule sst tests using this pr build and leapp-repository*master* as artifacts
  • /rerun-sst 42 to schedule sst tests using this pr build and leapp-repository*PR42* as artifacts

Please open ticket in case you experience technical problem with the CI. (RH internal only)

Note: In case there are problems with tests not being triggered automatically on new PR/commit or pending for a long time, please consider rerunning the CI by commenting leapp-ci build (might require several comments). If the problem persists, contact leapp-infra.

@matejmatuska matejmatuska force-pushed the refactor-docs branch 2 times, most recently from c502d92 to 8468c87 Compare August 6, 2024 12:02
@matejmatuska
Copy link
Member Author

Rebased

@matejmatuska matejmatuska marked this pull request as ready for review September 9, 2024 11:20
Copy link
Member

@pirat89 pirat89 left a comment

Choose a reason for hiding this comment

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

one change really needed

docs/Makefile Outdated Show resolved Hide resolved
docs/Makefile Outdated Show resolved Hide resolved
docs/Makefile Outdated Show resolved Hide resolved
@matejmatuska
Copy link
Member Author

Comments addressed and I also rebased.

@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@source venv/bin/activate && \
$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

livehtml:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
livehtml:
livehtml: html

this will automatically build html, so you do not need to think about it

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

Successfully merging this pull request may close these issues.

2 participants