Skip to content

incus: initial documentation - #423

Merged
tormath1 merged 2 commits into
masterfrom
tormath1/incus
May 20, 2025
Merged

tormath1 merged 2 commits into
masterfrom
tormath1/incus

Conversation

@tormath1

Copy link
Copy Markdown
Collaborator

This provides basic instructions:

  • installing
  • initializing
  • initializing with ZFS
  • operating

To be merged with: flatcar/scripts#1655

@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lemon-wave-085522403-423.westeurope.1.azurestaticapps.net

@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lemon-wave-085522403-423.westeurope.1.azurestaticapps.net

@tormath1
tormath1 marked this pull request as ready for review May 19, 2025 15:09
@tormath1
tormath1 requested a review from a team May 19, 2025 15:09
@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lemon-wave-085522403-423.westeurope.1.azurestaticapps.net

krnowak
krnowak previously approved these changes May 19, 2025

@krnowak krnowak left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Looks good, just had a question about relative vs absolute links.


[incus]: https://linuxcontainers.org/incus/
[documentation]: https://linuxcontainers.org/incus/docs/main/
[official-sysext]: https://www.flatcar.org/docs/latest/provisioning/sysext/#flatcar-release-extensions-official

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Do we have a rule about links to other pages in the flatcar docs? Whether these ought to be absolute links like this one here, or maybe relative ones. Relative links would point to an updated page within stage sites, but I'm not sure if the final website preserves the directory structure for the relative links to be valid in github repo and in the website.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

That's a good question. I wondered myself as well: it seems we're mixing both approaches across the documentation. I would be in favor of using relative links by default.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Well, it seems this one needs to stay with the full URL link as there is an anchor reference. See: https://discourse.gohugo.io/t/how-can-i-convert-markdown-files-contains-relative-link-with-end-with-md-to-hugo-links/42087/4

You cannot use markdown into markdown in such way. When Hugo generating pages it using markdown files to generate html output (or other) If you want to link to other page, you need to link to page URL as if it was live website. That’s the Markdown way, not Hugo.

I updated the other one.

sudo SYSTEMD_LOG_LEVEL=debug systemd-sysext refresh
```

[incusextension]: ../../container-runtimes/incus

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Seems like here we actually use relative paths.

@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lemon-wave-085522403-423.westeurope.1.azurestaticapps.net

@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lemon-wave-085522403-423.westeurope.1.azurestaticapps.net

@tormath1
tormath1 requested a review from krnowak May 20, 2025 07:39
Comment thread content/docs/latest/container-runtimes/incus.md Outdated
tormath1 added 2 commits May 20, 2025 11:25
This provides basic instructions:
* installing
* initializing
* initializing with ZFS
* operating

Signed-off-by: Mathieu Tortuyaux <[email protected]>
This unify documentation to use the actual sysext names from the
`systemd-sysext list` output.

Signed-off-by: Mathieu Tortuyaux <[email protected]>
@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://lemon-wave-085522403-423.westeurope.1.azurestaticapps.net

@John15321 John15321 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGMT!

@tormath1
tormath1 merged commit 2e79395 into master May 20, 2025
@tormath1
tormath1 deleted the tormath1/incus branch May 20, 2025 10:04
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.

3 participants