docs: Improve ability to select proper API/XML section

[PATCH 0/2] docs: Improve ability to select proper API/XML section

Posted by Peter Krempa via Devel 8 months, 2 weeks ago

Browse the result at:

https://pipo.sk.gitlab.io/-/libvirt/-/jobs/9603174377/artifacts/website/docs.html

(The security warning happens as my username on gitlab contains a dot.)

Peter Krempa (2):
  docs: Re-order XML schema after API documentation on 'docs' page
  docs: Render API and XML sections one per line in HTML

 docs/css/libvirt.css | 11 +++++++
 docs/docs.rst        | 75 +++++++++++++++++++++++---------------------
 2 files changed, 51 insertions(+), 35 deletions(-)

-- 
2.49.0

Re: [PATCH 0/2] docs: Improve ability to select proper API/XML section

Posted by Ján Tomko via Devel 8 months, 2 weeks ago

On a Wednesday in 2025, Peter Krempa via Devel wrote:
>Browse the result at:
>
>https://pipo.sk.gitlab.io/-/libvirt/-/jobs/9603174377/artifacts/website/docs.html
>
>(The security warning happens as my username on gitlab contains a dot.)
>

Have you considered changing it?

>Peter Krempa (2):
>  docs: Re-order XML schema after API documentation on 'docs' page
>  docs: Render API and XML sections one per line in HTML
>
> docs/css/libvirt.css | 11 +++++++
> docs/docs.rst        | 75 +++++++++++++++++++++++---------------------
> 2 files changed, 51 insertions(+), 35 deletions(-)
>

Reviewed-by: Ján Tomko <jtomko@redhat.com>

Jano

Re: [PATCH 0/2] docs: Improve ability to select proper API/XML section

Posted by Peter Krempa via Devel 8 months, 2 weeks ago

On Fri, Apr 04, 2025 at 14:41:13 +0200, Ján Tomko wrote:
> On a Wednesday in 2025, Peter Krempa via Devel wrote:
> > Browse the result at:
> > 
> > https://pipo.sk.gitlab.io/-/libvirt/-/jobs/9603174377/artifacts/website/docs.html
> > 
> > (The security warning happens as my username on gitlab contains a dot.)
> > 
> 
> Have you considered changing it?

Yes; and decided against.

> 
> > Peter Krempa (2):
> >  docs: Re-order XML schema after API documentation on 'docs' page
> >  docs: Render API and XML sections one per line in HTML
> > 
> > docs/css/libvirt.css | 11 +++++++
> > docs/docs.rst        | 75 +++++++++++++++++++++++---------------------
> > 2 files changed, 51 insertions(+), 35 deletions(-)
> > 
> 
> Reviewed-by: Ján Tomko <jtomko@redhat.com>
> 
> Jano