Skip to content

feat: update documentation and styling, add language/theme switcher to menu - #33

Merged
Stensel8 merged 2 commits into
mainfrom
development
Mar 1, 2026
Merged

feat: update documentation and styling, add language/theme switcher to menu#33
Stensel8 merged 2 commits into
mainfrom
development

Conversation

@Stensel8

@Stensel8 Stensel8 commented Mar 1, 2026

Copy link
Copy Markdown
Member

Summary

update documentation and styling, add language/theme switcher to menu

Type of change

  • feat — new page or feature
  • refactor — restructuring without content changes

PR title and commit types must follow these standards — view the contributing guide

Checklist

  • PR title follows the commit convention (e.g. fix: correct nmcli command in eduroam guide)
  • Both EN and NL versions updated (if applicable)
  • Media is in AVIF format (not PNG/JPG)
  • No broken image references (/images/*.avif all exist in static/images/)
  • Tested locally with hugo server

@Stensel8 Stensel8 self-assigned this Mar 1, 2026
Copilot AI review requested due to automatic review settings March 1, 2026 20:54
@Stensel8 Stensel8 added documentation Improvements or additions to documentation submodules Pull requests that update submodules code labels Mar 1, 2026
@Stensel8
Stensel8 merged commit db61d6d into main Mar 1, 2026
11 checks passed
@Stensel8
Stensel8 deleted the development branch March 1, 2026 20:58

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the Hugo/Hextra site UX and documentation presentation, including a new navbar language/theme control entry, refreshed landing-page copy, and improved readability of “Known Issues” pages.

Changes:

  • Add Language + Theme items to the main menu and adjust theme-toggle visibility behavior.
  • Refactor “Known Issues” (EN/NL) to use collapsible details sections.
  • Refresh homepage copy/system-info presentation and add the system-info.avif asset.

Reviewed changes

Copilot reviewed 14 out of 16 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
static/images/system-info.avif Adds the system info screenshot asset used on the homepage.
hugo.toml Adds menu items for language/theme controls and changes theme toggle display behavior.
content/docs/virtualization/winboat.nl.md Small NL doc polish (link label, alt text, references formatting).
content/docs/known-issues.nl.md Converts active issues to collapsible details blocks (NL).
content/docs/known-issues.md Converts active issues to collapsible details blocks (EN).
content/docs/getting-started.nl.md Removes the duplicated hardware block from the NL getting started page.
content/docs/getting-started.md Removes the duplicated hardware block from the EN getting started page.
content/docs/applications.nl.md Minor sentence punctuation tweak for readability (NL).
content/docs/_index.nl.md Updates docs landing page copy and feature-card subtitles (NL).
content/_index.nl.md Updates NL homepage hero/callout, adds RAM row + Copilot note, uses system-info image.
content/_index.md Updates EN homepage hero/callout, adds RAM row + Copilot note, uses system-info image.
assets/css/custom.css Adds styling for the system-info image in light mode, hides duplicate language/theme controls, adjusts hero badge sizing.
.gitignore Ignores Hugo module vendoring folder (/_vendor/).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

```

Packagebron: [packages.cachyos.orgwinboat](https://packages.cachyos.org/package/cachyos/x86_64/winboat)
Packagebron: [packages.cachyos.org/winboat](https://packages.cachyos.org/package/cachyos/x86_64/winboat)

Copilot AI Mar 1, 2026

Copy link

Choose a reason for hiding this comment

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

The link text packages.cachyos.org/winboat doesn’t match the actual target URL (which points to /package/cachyos/x86_64/winboat). Consider using a descriptive label (e.g., “CachyOS package”) or making the displayed URL match the href to avoid confusion.

Suggested change
Packagebron: [packages.cachyos.org/winboat](https://packages.cachyos.org/package/cachyos/x86_64/winboat)
Packagebron: [CachyOS packagepagina](https://packages.cachyos.org/package/cachyos/x86_64/winboat)

Copilot uses AI. Check for mistakes.
Comment thread content/_index.md

![System information overview](/images/system-info.avif)

<small style="opacity: 0.45;">Some documentation on this site has been written or improved with assistance from GitHub Copilot.</small>

Copilot AI Mar 1, 2026

Copy link

Choose a reason for hiding this comment

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

Inline styling (style="opacity: 0.45;") is the only style= usage in the content folder right now. For maintainability/theme consistency (especially across dark mode), it would be better to use existing Hextra utility classes or a named CSS class in assets/css/custom.css instead of inline styles.

Suggested change
<small style="opacity: 0.45;">Some documentation on this site has been written or improved with assistance from GitHub Copilot.</small>
<small class="copilot-note">Some documentation on this site has been written or improved with assistance from GitHub Copilot.</small>

Copilot uses AI. Check for mistakes.
Comment thread content/_index.nl.md

![Systeeminformatie-overzicht](/images/system-info.avif)

<small style="opacity: 0.45;">Een deel van de documentatie op deze site is geschreven of verbeterd met hulp van GitHub Copilot.</small>

Copilot AI Mar 1, 2026

Copy link

Choose a reason for hiding this comment

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

Inline styling (style="opacity: 0.45;") is the only style= usage in the content folder right now. For maintainability/theme consistency (especially across dark mode), it would be better to use existing Hextra utility classes or a named CSS class in assets/css/custom.css instead of inline styles.

Suggested change
<small style="opacity: 0.45;">Een deel van de documentatie op deze site is geschreven of verbeterd met hulp van GitHub Copilot.</small>
<small class="opacity-50">Een deel van de documentatie op deze site is geschreven of verbeterd met hulp van GitHub Copilot.</small>

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation submodules Pull requests that update submodules code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants