[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Texinfo, Free Beer

From: jgart
Subject: Texinfo, Free Beer
Date: Sat, 6 Aug 2022 08:30:01 -0500

Hi Guixers,

wdyt of having some modern TLDR entry in the cookbook for getting Guix 
neophytes up to par with texinfo?

Since texinfo is the defacto markup for the GNU Guix project and we're not 
likely to change it any time soon, 
I was think we could have some distilled/TLDR docs for users who mostly write 
and consume markdown.

I was thinking something along the lines of what chicken has for rubyists or 

"Texinfo for MDs"

roptat started a TLDR Texinfo guide on the learnxinyminutes series*.

Should we just improve on roptat's guide and link it in a Guix doc somewhere so
that it is more discoverable or integrate/fork it or similar into our docs?

Same way we have a Scheme crash course, we can have a Texinfo crash course?

It would be worth it since Texinfo seems more complex than Scheme from
a syntactic perspective and our new documentation contributors could
benefit from a crash course in Texinfo.

I think the GNU docs for texinfo are TMI for a new user just wanting to write 
some Guix docs for great good.

Another option could be to integrate guile-commonmark** into Guix so that
we could support markdown in addition to Texinfo? Please don't boo and
throw free beer at the stage.

Nix used to mostly have their docs in docbook but now they support
markdown and their users are much happier***



reply via email to

[Prev in Thread] Current Thread [Next in Thread]