[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 4/8] docs/sphinx: add CSS styling for qmp-example directive
From: |
Markus Armbruster |
Subject: |
Re: [PATCH 4/8] docs/sphinx: add CSS styling for qmp-example directive |
Date: |
Wed, 10 Jul 2024 06:37:25 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) |
John Snow <jsnow@redhat.com> writes:
> On Tue, Jul 9, 2024 at 6:34 AM Markus Armbruster <armbru@redhat.com> wrote:
>
>> John Snow <jsnow@redhat.com> writes:
>>
>> > From: Harmonie Snow <harmonie@gmail.com>
>> >
>> > Add CSS styling for qmp-example directives to increase readability and
>> > consistently style all example blocks.
>> >
>> > Signed-off-by: Harmonie Snow <harmonie@gmail.com>
>> > Signed-off-by: John Snow <jsnow@redhat.com>
>>
>> Same sadness as for the previous patch.
>>
>
> Should we do anything about that? In the long run, I don't expect anyone
> will actually need to care about what this directive looked like in some
> intermediate state before we ever used it. If you want to evaluate the
> directive in the in-between states, I recommend modifying a document and
> seeing what it does; but I didn't really intend for anyone to really see it
> that way.
>
> (Isn't it a bit overboard to write unit tests for intermediate tree
> states...?)
I'm not asking for temporary tests, I just wonder why you delay
permanent ones until "[PATCH 8/8] qapi: remove "Example" doc section".
No big deal, thus:
>> Acked-by: Markus Armbruster <armbru@redhat.com>
- Re: [PATCH 1/8] docs/qapidoc: factor out do_parse(), (continued)
[PATCH 2/8] docs/qapidoc: create qmp-example directive, John Snow, 2024/07/03
[PATCH 3/8] docs/qapidoc: add QMP highlighting to annotated qmp-example blocks, John Snow, 2024/07/03
[PATCH 4/8] docs/sphinx: add CSS styling for qmp-example directive, John Snow, 2024/07/03
[PATCH 5/8] qapi: convert "Example" sections without titles, John Snow, 2024/07/03
[PATCH 6/8] qapi: convert "Example" sections with titles, John Snow, 2024/07/03
[PATCH 7/8] qapi: convert "Example" sections with longer prose, John Snow, 2024/07/03
[PATCH 8/8] qapi: remove "Example" doc section, John Snow, 2024/07/03