Commit Graph
12 Commits
Author SHA1 Message Date
Oded Viner 5183ecdff4 doc: switch linux minikube driver from kvm2 to qemu2
update the developer guide to use the qemu2 driver instead of kvm2
for minikube on linux.

Signed-off-by: Oded Viner <oviner@redhat.com>
2025-07-02 14:48:04 +03:00
Michael AdamandTravis Nielsen 1b43ae996c docs: improve dev guide regarding helm installation
The development guide mentioned that `tests/scripts/helm.sh up` would
install and set up the charts built under  `_output/charts`.

This is not correct as the script only downloads helm to a temporary
directry.

This change improves the dev guide by removing  these  incorrect
statements.

Signed-off-by: Michael Adam <obnox@samba.org>
Co-authored-by: Travis Nielsen <tnielsen@redhat.com>
2025-06-06 17:51:40 +02:00
Michael Adam ef267ee8bf helm: remove mention of helm.sh clean
tests/scripts/helm.sh clean is not implemented.

So  remove frpom the script's help text
and from the development guilde

Signed-off-by: Michael Adam <obnox@samba.org>
2025-06-06 17:51:40 +02:00
Blaine Gardner c9d99e01a0 ci: use markdownlint to enforce mkdocs compatibility
mkdocs uses a markdown renderer that is hardcoded to 4 spaces per tab
for detecting indentation levels, including ordered- and
unordered-lists. Since we cannot easily change the renderer, begin using
a markdown linter in CI that will fail if official docs do not adhere to
the spacing rules.

As a starting point, the markdownlint config does not begin with the
default set of checks, which might overwhelm attempts to fix them.
Instead, focus on list-tab-spacing rules and a few other highly useful
checks.

markdownlint also has some gaps in its abilities that allow common Rook
doc issues to pass acceptance. However, it allows creating custom
linting plugins. Create 2 such linting plugins to check 2 things:

- all doc lines (except code blocks) must be aligned to a 4-space
  boundary, without exception. This ensures that markdown will render
  correctly with mkdocs. This unfortunately makes it possible to create
  lists that are internally aligned strangely.
- admonitions must all follow the same format of
  ```
  !!! header
      body
  ```

For the strange lists, this is allowed and renders correctly, but it
looks strange:

```md
- first bullet
- second bullet
    still second bullet
- third bullet

    has a paragraph
    of text inside

- last bullet

Signed-off-by: Blaine Gardner <blaine.gardner@ibm.com>
2024-04-29 17:25:11 -06:00
Redouane Kachach b9501bdddb test: adding support for multi-rook clusters creation
This change introduce a new argument -p to specify the minikube
profile for the new cluster. This way we can have multiple rook
clusters running on the same machine.

Signed-off-by: Redouane Kachach <rkachach@redhat.com>
2023-11-08 13:29:46 +01:00
Redouane Kachach 73b7e649d7 test: adding a script to simplify test cluster creation
Signed-off-by: Redouane Kachach <rkachach@redhat.com>
2023-10-30 16:48:49 +01:00
Redouane Kachach e32ece275c docs: fixing typos
Signed-off-by: Redouane Kachach <rkachach@redhat.com>
2023-10-05 20:17:15 +02:00
Redouane Kachach 5f4fae4f3b docs: improving minikube setup documentation
Adding some detailed instructions on how to use the local
built Rook image on minikube cluster

Signed-off-by: Redouane Kachach <rkachach@redhat.com>
2023-10-04 10:51:12 +02:00
Blaine Gardner a57d972aa1 docs: suggest qeumu driver for minikube on apple silicon
Apple silicon does not support hyperkit, and virtualbox does not support
Apple silicon (yet). Suggest the QEMU driver for development on MacOS
with Apple silicon.

Signed-off-by: Blaine Gardner <blaine.gardner@redhat.com>
2023-06-14 11:08:11 -06:00
Sheetal Pamecha 422b037cab docs: correct link for helm.sh file
Signed-off-by: Sheetal Pamecha <spamecha@redhat.com>
2023-05-08 09:58:48 +05:30
Tarun Gupta Akirala 6c2335b37a docs: fix notes in contributing docs
Signed-off-by: Tarun Gupta Akirala <takirala@users.noreply.github.com>
2022-10-04 17:18:33 -07:00
Alexander Trost 74431443e3 docs: use mkdocs and restructure docs
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-05-18 16:06:22 +02:00