Skip to content

incus: initial documentation#423

Merged
tormath1 merged 2 commits intomasterfrom
tormath1/incus
May 20, 2025
Merged

incus: initial documentation#423
tormath1 merged 2 commits intomasterfrom
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
Copy link
Copy Markdown
Member

@krnowak krnowak left a comment

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
tormath1 added 2 commits May 20, 2025 11:25
This provides basic instructions:
* installing
* initializing
* initializing with ZFS
* operating

Signed-off-by: Mathieu Tortuyaux <mtortuyaux@microsoft.com>
This unify documentation to use the actual sysext names from the
`systemd-sysext list` output.

Signed-off-by: Mathieu Tortuyaux <mtortuyaux@microsoft.com>
@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

Copy link
Copy Markdown
Member

@John15321 John15321 left a comment

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
2 checks passed
@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