I've shortened this README based on what we came up with in this issue: docs/tickets#36 (comment)
Also I've kept there guidelines and important formatting rules due to the nature of this repo.
Co-authored-by: Christian Strauf <>
Reviewed-on: #18
Reviewed-by: Mat H <theprogram@noreply.forge.fedoraproject.org>
Co-authored-by: Christian Strauf <cstrauf@noreply.forge.fedoraproject.org>
Co-committed-by: Christian Strauf <cstrauf@noreply.forge.fedoraproject.org>
Co-authored-by: Christian Strauf <>
Reviewed-on: #17
Reviewed-by: Mat H <theprogram@noreply.forge.fedoraproject.org>
Co-authored-by: Christian Strauf <cstrauf@noreply.forge.fedoraproject.org>
Co-committed-by: Christian Strauf <cstrauf@noreply.forge.fedoraproject.org>
The SANE list of supported devices isn't comprehensive, so encourage the user to try their device anyway.
Addresses #15.
Reviewed-on: #14
Reviewed-by: Christian Strauf <cstrauf@noreply.forge.fedoraproject.org>
Co-authored-by: pg-tips <pg-tips@noreply.forge.fedoraproject.org>
Co-committed-by: pg-tips <pg-tips@noreply.forge.fedoraproject.org>
- Improve formatting and typographic style.
- Split sentences in paragraphs into separate lines to
improve AsciiDoc source code clarity.
- Convert numbered feature lists to proper AsciiDoc ordered list
syntax.
- Standardize Wi-Fi capitalization throughout.
- Replace raw URLs with descriptive link text.
- Minor grammar refinements and sentence-level rewording.
- Add :experimental: attribute for kbd: macro support.
- Use kbd:[] macro for keyboard keys.
Assisted-by: Claude Haiku 4.5
Signed-off-by: Hristo Marinov <hricky@mail.bg>
- Improve formatting and typographic style.
- Split sentences in paragraphs into separate lines to
improve AsciiDoc source code clarity.
- Replace manual reference with proper cross-reference (xref)
for "Connecting to Internet or Wi-Fi" section.
- Standardize Wi-Fi capitalization throughout.
Assisted-by: Claude Haiku 4.5
Signed-off-by: Hristo Marinov <hricky@mail.bg>
- Improve formatting and typographic style.
- Split sentences in paragraphs into separate lines to
improve AsciiDoc source code clarity.
- Add colons after list introductions.
- Standardize Wi-Fi capitalization throughout.
- Replace raw URLs with descriptive link text.
- Change OSX to macOS.
- Add :experimental: attribute for kbd: macro support.
- Use kbd:[] macro for keyboard keys.
Assisted-by: Claude Haiku 4.5
Signed-off-by: Hristo Marinov <hricky@mail.bg>
- Improve formatting and typographic style.
- Fix spacing around punctuation.
- Add proper link to Fedora Localization Team documentation.
- Split sentences in paragraphs into separate lines to
improve AsciiDoc source code clarity.
Assisted-by: Claude Haiku 4.5
Signed-off-by: Hristo Marinov <hricky@mail.bg>
Small edit to address #10.
Reviewed-on: #11
Reviewed-by: Mat H <theprogram@noreply.forge.fedoraproject.org>
Co-authored-by: pg-tips <pg_forums@runbox.com>
Co-committed-by: pg-tips <pg_forums@runbox.com>
- Replace [,shell] with [source,console] for proper syntax highlighting
- Change shell prompt from > to $ for standard convention
- Implement one sentence per line principle for improved readability
and maintainability
- Add missing backticks around tool names (sudo, dnf, ps, kill, etc.)
- Improve link formatting and remove unnecessary carets (^)
- Add proper colons after introductory phrases
- Add :experimental: attribute to enable kbd:[] macro
- Replace ASCII emoticon with proper AsciiDoc icon macro
- Fix typos and improve sentence structure
These changes enhance both the source readability and the rendered
documentation without altering any technical content or concepts.
Assisted-by: Claude Haiku 4.5 only for the commit message
Signed-off-by: Hristo Marinov <hricky@mail.bg>
