Subject: Re: [PATCH 1/1] doc: git-bisect: convert to new doc format

From: Junio C Hamano <[email-masked]>
Date: Tue, 13 Jan 2026 04:54:23 -0800

Jean-Noël AVILA <[email-masked]> writes:

>>  ------------
>> -$ git bisect run my_script arguments
>> +$ git bisect run <my_script> <arguments>
>>  ------------
>
> Here, if you want to use to use the synopsis formatting, you may replace the 
> verbatim block with a [synopsis] one:
>
> [synopsis]
> $ git bisect run <my_script> <arguments>
>

Can you add a bit to "if you _want_ to use" above?  What's the
pros-and-cons of doing so or leaving it as the way it is written in
the patch?  That would help people on the same page when they decide
if they want to use the [synopsis], preferring over the verbatim
block.

> Otherwise, LGTM
> Thanks.

Thanks for a review.