[Top][All Lists]

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

Re: [Taler] (docs) /private/orders

From: Thien-Thi Nguyen
Subject: Re: [Taler] (docs) /private/orders
Date: Tue, 30 Nov 2021 01:50:30 -0500
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux)

() Christian Grothoff <grothoff@gnunet.org>
() Mon, 29 Nov 2021 09:37:20 +0100

   Maybe having multiple lines for the choices would be better
   for Sphinx (see around line 968). We could indeed even go
   further and spell out all variants:

   .. http:patch:: /management/instances/$INSTANCE
   .. http:patch:: /instances/$INSTANCE/private
   .. http:patch:: /private

   Would that fix the Sphinx link resolution?

I think it would.  I have pushed temporary branch ‘dev/ttn’ w/
a small change to see how people feel about it:


Also, attached are a couple screenshots from my system:

Attachment: foo.png
Description: PNG image

Attachment: bar.png
Description: PNG image

This was the minimal change needed for taler-nfc-guide.rst to
compile cleanly (w/o warnings).  It's not future proof.

IMHO, the result is less pleasing to the eye than the original,
and could be confusing, as well.  There is also the discrepency
between including and excluding the trailing ‘$ORDER_ID’.  To
"properly" accomodate all the possibilities would be to succumb
to a combinatorial explosion -- not a good strategy for display
(readability) or maintenance.

So, overall, i think the best thing to do is to teach Sphinx
about optionality somehow (or help others do so), and live w/
the warnings, however irksome they may be, for now.

Thien-Thi Nguyen -----------------------------------------------
 (defun responsep (query)               ; (2021) Software Libero
   (pcase (context query)               ;       = Dissenso Etico
     (`(technical ,ml) (correctp ml))
     ...))                              748E A0E8 1CB8 A748 9BFA
--------------------------------------- 6CE4 6703 2224 4C80 7502

Attachment: signature.asc
Description: PGP signature

reply via email to

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