All of lore.kernel.org
 help / color / mirror / Atom feed
* [python-qemu-qmp MR] Add Sphinx documentation
@ 2022-05-03 20:44 John Snow
  0 siblings, 0 replies; only message in thread
From: John Snow @ 2022-05-03 20:44 UTC (permalink / raw)
  To: qemu-devel
  Cc: Cleber Rosa, Kashyap Chamarthy, Beraldo Leal, Daniel Berrange,
	Damien Hedde

I'm continuing to mail these manually for now, until I settle on an
automated solution or feel like there's enough buy-in on the GitLab
instance to not warrant the advertisement. Please consider
starring/watching the repo if you're interested in QMP lib updates as
I try to angle for an initial public release.

-

MR: https://gitlab.com/qemu-project/python-qemu-qmp/-/merge_requests/4
From: https://gitlab.com/jsnow

Howdy! This MR:

- Adds sphinx documentation as a build artifact
- Ensures documentation builds without errors in the CI pipeline
(preventing stale cross-reference bitrot)
- Publishes docs to e.g. https://jsnow.gitlab.io/python-qemu-qmp/
- Revamps some of the docstrings to make the rendered output more
appealing/accurate/etc.

I'm looking for holistic feedback on the documentation. Feedback on
grammar, readability, layout and presentation of the HTML docs, etc
are all welcome. If you have feedback on the design of the library
itself: that is also extremely welcome, but may need to be addressed
in subsequent MRs, filed as issues/bugs/change-requests and so on.

Note: This MR is going to show a failed pipeline. This is due to other
GitLab configuration issues that I'm working on addressing in !3.
However, I wanted to begin soliciting feedback on the documentation
here in the meantime, because I predict it will be a very iterative
process.



^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2022-05-03 23:06 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-05-03 20:44 [python-qemu-qmp MR] Add Sphinx documentation John Snow

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.