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

[Christian Grothoff]

On 11/29/21 8:56 AM, Thien-Thi Nguyen wrote:
> 
> () Thien-Thi Nguyen <ttn@gnuvola.org>
> () Mon, 29 Nov 2021 02:07:53 -0500
> 
>    Is this a problem with Sphinx or a legitimate problem with
>    the source text?
> 
> IIUC, the "[/instance/$INSTANCE]" is optional (indicated by the
> square brackets) in:
> 
>  https://git.taler.net/docs.git/tree/core/api-merchant.rst#n1621
> 
> So a "plain" ":http:post:/private/orders" SHOULD be okay right?

Indeed.

> This leads me to believe it is a problem w/ specifying the
> optionality of the /instance/$INSTANCE part to Sphinx.  Hmmm.
> What am i missing?

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?

signature.asc
Description: OpenPGP digital signature