guix.info: Missing manual

  • Done
  • quality assurance status badge
Details
5 participants
  • Ludovic Courtès
  • Pierre Neidhardt
  • Tobias Geerinckx-Rice
  • Ricardo Wurmus
  • sirgazil
Owner
unassigned
Submitted by
Pierre Neidhardt
Severity
normal
P
P
Pierre Neidhardt wrote on 26 Sep 2018 12:33
(address . bug-guix@gnu.org)
87y3bolf9v.fsf@ambrevar.xyz
The manual is missing from https://guix.info/manual/.

--
Pierre Neidhardt
-----BEGIN PGP SIGNATURE-----

iQEzBAEBCAAdFiEEUPM+LlsMPZAEJKvom9z0l6S7zH8FAlurYGwACgkQm9z0l6S7
zH8wCwgArzazqCQ7UIomoxFz3QEHbJDp4IB8X2c/Yuu4wgTc/I0pB53K7HTSVzx6
Ng+51jgWMnqJXckncYdSx9us2+I8FJS8PzJ4MinPdcK9atk54bGkZMeFkJ9IukHt
NsPgAkJiqCs6+77uPs03qV6l3bUmz2YqFREqlJwkBcFGhjiarWGE1920rvYi0gUa
iK/X/F1nrItVqRldkSBVtUhCdUPyLLEByqHrBH8/a41v6iPcxCrP8X+fzoAekdNf
pK0r7Kk3BpJ5kQQyqisq0j56GgR/4JpCIhTONL9QAc8eenEKr2XIXQRt/RbA3WyS
WVMzm0rnNoXEoZgFzhPkUonzkj1sXg==
=f7JY
-----END PGP SIGNATURE-----

R
P
P
Pierre Neidhardt wrote on 26 Sep 2018 21:44
(name . Ricardo Wurmus)(address . rekado@elephly.net)(address . 32845@debbugs.gnu.org)
87efdgjb7h.fsf@ambrevar.xyz
Then we need to update the links on https://guix.info/help/.
I think the Savannah version is not in sync with those localized manuals.

--
Pierre Neidhardt
-----BEGIN PGP SIGNATURE-----

iQEzBAEBCAAdFiEEUPM+LlsMPZAEJKvom9z0l6S7zH8FAlur4YIACgkQm9z0l6S7
zH+qeQf+PgIhueAQICrwgqO99BB4LdtqPvwEUpYKJzmAgUPhq8sv/yvGU5GBOfjn
P7oIeZnWJFL+5nJA7yL6IB61KndQuHDsN5jIb7JdkJDR0N+/QJ9o1Igd26W8FU9n
jMrsOmYhgu9cUUgt5jWaL+CMoWjsUqN4CFLvFmHOTko82SiPqHnGPC8Exqwq9BJG
xtuO8rMlNVY2iws+2qSiFB/c3EB6YT+BGhubS84L2WBAoV4zm1z6bXc7BUh5A9ab
XCxYQn2QaIpmlTT5Ytr9jTdWwHzqr8KvJiU/TqZmWBHJFbacVheZEi++k8pj1Y6l
Yr6jNed5K/E61k6hTZhte5H0BtCQbA==
=kXoW
-----END PGP SIGNATURE-----

R
R
Ricardo Wurmus wrote on 26 Sep 2018 22:10
(name . Pierre Neidhardt)(address . mail@ambrevar.xyz)(address . 32845@debbugs.gnu.org)
87zhw4rpel.fsf@elephly.net
Pierre Neidhardt <mail@ambrevar.xyz> writes:

Toggle quote (3 lines)
> Then we need to update the links on https://guix.info/help/.
> I think the Savannah version is not in sync with those localized manuals.

Indeed. The problem here is that the documentation is not actually part
of our website build. It is part of the GNU-hosted manuals.

The copy at guix.info does not use the same gnu.org/software/guix
prefix, so all links to the manual are likely wrong.

This needs to be fixed in our website code, so that the same code works
for both sites.

--
Ricardo
L
L
Ludovic Courtès wrote on 27 Sep 2018 15:46
(name . Ricardo Wurmus)(address . rekado@elephly.net)
87ftxv3vf4.fsf@gnu.org
Hello,

Ricardo Wurmus <rekado@elephly.net> skribis:

Toggle quote (6 lines)
> The copy at guix.info does not use the same gnu.org/software/guix
> prefix, so all links to the manual are likely wrong.
>
> This needs to be fixed in our website code, so that the same code works
> for both sites.

I wonder what should be done with guix.info: should we keep it as a
mirror, or should it redirect to gnu.org, or the opposite?

My initial plan was to use guix.gnu.org as the primary domain but we’re
stuck with the “Let’s Encrypt vs. multiple entries in DNS A records”
issue. At the same time, guix.info works just fine.

Thoughts?

Ludo’.
R
R
Ricardo Wurmus wrote on 27 Sep 2018 17:28
(name . Ludovic Courtès)(address . ludo@gnu.org)
87r2hfrmcf.fsf@elephly.net
Ludovic Courtès <ludo@gnu.org> writes:

Toggle quote (13 lines)
> Hello,
>
> Ricardo Wurmus <rekado@elephly.net> skribis:
>
>> The copy at guix.info does not use the same gnu.org/software/guix
>> prefix, so all links to the manual are likely wrong.
>>
>> This needs to be fixed in our website code, so that the same code works
>> for both sites.
>
> I wonder what should be done with guix.info: should we keep it as a
> mirror, or should it redirect to gnu.org, or the opposite?

I really don’t know. I didn’t plan for guix.info to become popular, but
it certainly is convenient right now as we can change DNS records at a
whim.

Currently, the manual shown on guix.info is fairly close to the latest
in git. This means it contains documentation about channels, which
cannot be found in the latest release that matches the manual on
gnu.org.

Toggle quote (4 lines)
> My initial plan was to use guix.gnu.org as the primary domain but we’re
> stuck with the “Let’s Encrypt vs. multiple entries in DNS A records”
> issue. At the same time, guix.info works just fine.

I thought the bigger issue was running a DNS server, which is something
I’ve never done and wouldn’t like to take on myself.

The problem with naive Let’s Encrypt updates is that automatic
challenges might fail when the “wrong” server is returned by the DNS
server. “certbot” can be used with manual DNS validation, which
requires us to deploy a DNS TXT record. This can be automated with
certbot hooks (scripts that have access to the token that should be
published via environment variables) or through JSON mode, which returns
an object with the token that can be processed through other means.

I think the Let’s Encrypt updates shouldn’t be a blocker.

--
Ricardo
P
P
Pierre Neidhardt wrote on 27 Sep 2018 19:37
(name . Ricardo Wurmus)(address . rekado@elephly.net)
87va6q2652.fsf@ambrevar.xyz
Toggle quote (5 lines)
> Currently, the manual shown on guix.info is fairly close to the latest
> in git. This means it contains documentation about channels, which
> cannot be found in the latest release that matches the manual on
> gnu.org.

This is crucial, I believe. I believe. "Static" documentation is a Bad Idea.
I think the manual is better than a wiki, but only if contributors can work on
it "live".

--
Pierre Neidhardt
-----BEGIN PGP SIGNATURE-----

iQEzBAEBCAAdFiEEUPM+LlsMPZAEJKvom9z0l6S7zH8FAlutFWkACgkQm9z0l6S7
zH+YVQf+JZ3pGQwhmYyzF72Wsdcb57W7z66f1bQVglAbOdJG+kdijGfmwueqLhml
CLRMzZ/ulhzWiz6rcO2IGoTE0D+TYaR0gGCws8iOBvhhdVhz/aG+Ln2gFqedzqMy
5WvUwavj1uMriODsDMaVpw3/s6+t+5cwGnn4LDdao1a5GdBmsk9EAFr/cvz+sYcl
GibzGs6ylRmdFEuF0yv2w5jdLqAO/q/Du7VaI6yGdOSNUnFQ5gI6CO4JXTN4YSTC
FNMf8YLkfdeGKShadIvJqOuJ1FaN7uyRARUW22yV7eD2oHCjUH3WA6Mq6bhmSC1B
OrnI51NffXQPJsRM5btwfyFOspHqSQ==
=Dkym
-----END PGP SIGNATURE-----

L
L
Ludovic Courtès wrote on 28 Sep 2018 22:03
(name . Ricardo Wurmus)(address . rekado@elephly.net)
87h8i91jaq.fsf@gnu.org
Hello!

Ricardo Wurmus <rekado@elephly.net> skribis:

Toggle quote (2 lines)
> Ludovic Courtès <ludo@gnu.org> writes:

[...]

Toggle quote (12 lines)
>> I wonder what should be done with guix.info: should we keep it as a
>> mirror, or should it redirect to gnu.org, or the opposite?
>
> I really don’t know. I didn’t plan for guix.info to become popular, but
> it certainly is convenient right now as we can change DNS records at a
> whim.
>
> Currently, the manual shown on guix.info is fairly close to the latest
> in git. This means it contains documentation about channels, which
> cannot be found in the latest release that matches the manual on
> gnu.org.

Yes, it’s convenient.

Toggle quote (7 lines)
>> My initial plan was to use guix.gnu.org as the primary domain but we’re
>> stuck with the “Let’s Encrypt vs. multiple entries in DNS A records”
>> issue. At the same time, guix.info works just fine.
>
> I thought the bigger issue was running a DNS server, which is something
> I’ve never done and wouldn’t like to take on myself.

I’ve never done it either :-) but our Knot service makes it looks easy.

Toggle quote (8 lines)
> The problem with naive Let’s Encrypt updates is that automatic
> challenges might fail when the “wrong” server is returned by the DNS
> server. “certbot” can be used with manual DNS validation, which
> requires us to deploy a DNS TXT record. This can be automated with
> certbot hooks (scripts that have access to the token that should be
> published via environment variables) or through JSON mode, which returns
> an object with the token that can be processed through other means.

I didn’t know about all this! Looks like our Certbot service doesn’t
support it though?

Toggle quote (2 lines)
> I think the Let’s Encrypt updates shouldn’t be a blocker.

To me it was the main blocker.

Let’s see if we can bring more knowledgeable people on board…

Ludo’.
L
L
Ludovic Courtès wrote on 28 Sep 2018 22:08
(name . Pierre Neidhardt)(address . mail@ambrevar.xyz)
877ej51j2n.fsf@gnu.org
Pierre Neidhardt <mail@ambrevar.xyz> skribis:

Toggle quote (9 lines)
>> Currently, the manual shown on guix.info is fairly close to the latest
>> in git. This means it contains documentation about channels, which
>> cannot be found in the latest release that matches the manual on
>> gnu.org.
>
> This is crucial, I believe. I believe. "Static" documentation is a Bad Idea.
> I think the manual is better than a wiki, but only if contributors can work on
> it "live".

One obvious problem with documentation on the web is that it’s hard to
tell if it matches the version of what you’re actually using. (That’s
one of the reasons for the “Documentation” section in the manual.)

The only reason IMO that justifies keeping “static” documentation (for
the latest release) is the installation instructions: these may change
anytime in ‘master’, but it’s important that those on-line match what
people will actually download.

Thoughts?

Ludo’.
T
T
Tobias Geerinckx-Rice wrote on 28 Sep 2018 22:39
(name . Ludovic Courtès)(address . ludo@gnu.org)
87a7o1nypy.fsf@tobias.gr
Ludo', Guix,

Ludovic Courtès wrote:
Toggle quote (15 lines)
> Ricardo Wurmus <rekado@elephly.net> skribis:
>> “certbot” can be used with manual DNS validation, which
>> requires us to deploy a DNS TXT record. This can be automated
>> with
>> certbot hooks (scripts that have access to the token that
>> should be
>> published via environment variables) or through JSON mode,
>> which returns
>> an object with the token that can be processed through other
>> means.
>
> I didn’t know about all this! Looks like our Certbot service
> doesn’t
> support it though?

Not out of the box, and last time I checked vanilla certbot didn't
provide an nsupdate (RFC2136) hook alongside all the DNSaaS API
rubbish.

But it's certainly possible, and wonderfully stable once set
up. t.gr runs entirely on GuixSD + Knot + DNS-validated LE certs.

Kind regards,

T G-R
L
L
Ludovic Courtès wrote on 29 Sep 2018 18:14
(name . Tobias Geerinckx-Rice)(address . me@tobias.gr)
87o9cgz3f7.fsf@gnu.org
Hi Tobias,

Tobias Geerinckx-Rice <me@tobias.gr> skribis:

Toggle quote (20 lines)
> Ludovic Courtès wrote:
>> Ricardo Wurmus <rekado@elephly.net> skribis:
>>> “certbot” can be used with manual DNS validation, which
>>> requires us to deploy a DNS TXT record. This can be automated with
>>> certbot hooks (scripts that have access to the token that should be
>>> published via environment variables) or through JSON mode, which
>>> returns
>>> an object with the token that can be processed through other means.
>>
>> I didn’t know about all this! Looks like our Certbot service
>> doesn’t
>> support it though?
>
> Not out of the box, and last time I checked vanilla certbot didn't
> provide an nsupdate (RFC2136) hook alongside all the DNSaaS API
> rubbish.
>
> But it's certainly possible, and wonderfully stable once set up. t.gr
> runs entirely on GuixSD + Knot + DNS-validated LE certs.

Neat. Would you like to help come up with a Knot & Certbot config for
guix.gnu.org? :-)

The peculiarity is this:

Toggle snippet (5 lines)
$ getent hosts guix.gnu.org
141.80.181.40 guix.gnu.org
185.233.100.56 guix.gnu.org

Ludo’.
R
R
Ricardo Wurmus wrote on 28 Sep 2018 22:38
(name . Ludovic Courtès)(address . ludo@gnu.org)
87mus1bbnz.fsf@elephly.net
Ludovic Courtès <ludo@gnu.org> writes:

Toggle quote (11 lines)
>> The problem with naive Let’s Encrypt updates is that automatic
>> challenges might fail when the “wrong” server is returned by the DNS
>> server. “certbot” can be used with manual DNS validation, which
>> requires us to deploy a DNS TXT record. This can be automated with
>> certbot hooks (scripts that have access to the token that should be
>> published via environment variables) or through JSON mode, which returns
>> an object with the token that can be processed through other means.
>
> I didn’t know about all this! Looks like our Certbot service doesn’t
> support it though?

That’s right. The question is what we want to do in the auth hook when
this is performed in the service. We could just punt and have the user
supply the path to a custom hook script.

Toggle quote (2 lines)
> Let’s see if we can bring more knowledgeable people on board…

Yes please! :)

--
Ricardo
S
S
sirgazil wrote on 25 Jan 2020 19:00
guix.info: Missing manual
(name . 32845)(address . 32845@debbugs.gnu.org)
16fdddcb579.10f3166aa32604.7332330738350003672@zoho.com
The "https://guix.info/manual/"currently redirects to "https://guix.gnu.org/manual/", which links to the manual in different languages.

Problem solved?
L
L
Ludovic Courtès wrote on 28 Jan 2020 11:28
(name . sirgazil via Bug reports for GNU Guix)(address . bug-guix@gnu.org)
87a767j2o0.fsf@gnu.org
Hi,

sirgazil via Bug reports for GNU Guix <bug-guix@gnu.org> skribis:

Toggle quote (4 lines)
> The "https://guix.info/manual/"currently redirects to "https://guix.gnu.org/manual/", which links to the manual in different languages.
>
> Problem solved?

I think so, thanks!

Ludo’.
?