Skip to content

Conversation

mudge
Copy link
Contributor

@mudge mudge commented Jun 26, 2025

Taken from a document provided by @ghollingworth, convert it to Asciidoc and add it to the "Computers" section of the documentation site (alongside other software-related sections such as "Raspberry Pi OS", "The Linux kernel", "Camera software", etc.).

Note the use of Asciidoc's formal passthrough macro to render +rpt and # as literals, see https://docs.asciidoctor.org/asciidoc/latest/text/literal-monospace/

Full-size screenshot from Chrome:

127 0 0 1_4000_documentation_computers_software-sources html(iPad Pro)

@mudge
Copy link
Contributor Author

mudge commented Jun 26, 2025

And a full-size screenshot of the updated documentation landing page:

127 0 0 1_4000_documentation(iPad Pro)

@mudge mudge force-pushed the software-sources branch from ca5bcb1 to b106360 Compare June 26, 2025 13:32
@JamesH65
Copy link
Contributor

Couple of possible typos. Debian needs a capital D. The Applications section has some odd capitalisations which I don't think are right.

@mudge mudge force-pushed the software-sources branch from fe50c4f to b106360 Compare June 26, 2025 14:20
Taken from a document provided by @ghollingworth, convert it to Asciidoc
and add it to the "Computers" section of the documentation site
(alongside other software-related sections such as "Raspberry Pi OS",
"The Linux kernel", "Camera software", etc.).

Note the use of Asciidoc's formal passthrough macro to render `+rpt` and
`#` as literals, see
https://docs.asciidoctor.org/asciidoc/latest/text/literal-monospace/
@mudge mudge force-pushed the software-sources branch from b106360 to c05c1e0 Compare June 26, 2025 14:26
@mudge
Copy link
Contributor Author

mudge commented Jun 26, 2025

Couple of possible typos. Debian needs a capital D. The Applications section has some odd capitalisations which I don't think are right.

I've capitalised Debian and removed the capitals from "Camera". I'll leave other copy changes for now so we can get the initial version of this live and then edit from there (unless there is anything obviously wrong is a showstopper).

@mudge mudge merged commit d0a3115 into develop Jun 26, 2025
1 check passed
@mudge mudge deleted the software-sources branch June 26, 2025 14:30
@ghollingworth
Copy link
Contributor

It should go through copy-edit... I didn't go through it at all... It's currently just "type as fast as I can" content...

Gordon

@ghollingworth
Copy link
Contributor

But, I agree that CE'ing shouldn't delay the output of documentation... Even Gordon's writing is better than no writing...

:)

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