-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Currently, there are multiple ways manpages are generated and handled
for Qubes tooling, listed below are repositories that likely should
have manpages (primarily command line tools)
qubes-app-linux-img-converter: native in same package, in root of
repository
qubes-app-linux-pdf-converter: none
qubes-app-linux-split-gpg: none
qubes-core-admin: pandoc (rst) and separate docs package, in doc
folder in repo
qubes-core-admin-linux: pandoc (rst) in same package, in doc folder in
repo
qubes-core-qubesdb: none
qubes-mgmt-salt: none
Standardizing manpages and how they should be generated would allow
new users to more easily contribute, new packages to be more easily
on-boarded, and new distros to more easily package Qubes tools. I
propose that each package have a separate docs package, generated from
pandoc, with the source having restructured text in the doc folder in
each repo.
As somewhat an aside, it might also be worth adding a README to each
repo with a brief explanation of what the repository is for, again to
easy the process of on-boarding new user.
kulinacs <
nick...@kulinacs.com>
-----BEGIN PGP SIGNATURE-----
iQIzBAEBCAAdFiEEPL+ie5e8l/3OecVUuXLc0JPgMlYFAlhZnMMACgkQuXLc0JPg
MlYUlA/9Fmm3lifJb/ZjgS7IrMP07BmxifDq7uzqgDiyCQnNj8x7IwDM4jsDJhrQ
yhWeGgCZ2YPMD6qDjmnXYSyOuygSoRfRHg32VakwbQlXg6PuBgVAwdEphwdQC6qA
rRgh0vYxSxjZjmd0RMyKwPF9S7aY6NicGMjJIcuDftMteBDgCBtsPTG3Qmc0b1Eg
RRQXFDwOnGqHYTNZi1dPGqX0y1aYLKwN0yLSyc0S/+CKiz7rUVLYhjx0bcE3bs9K
wRxzW4kDQdZUZiTCVhAP3H5rILhVDt4ioe8IUj6HdPErgft+tW7Ro7+IGM/RHi3r
H1LZhV90bJobQ2YM/zixx9pUUOqBwUAHWYd/T1rsmp3BUcAffvjS2XfxgKNFvI30
j0KC/ewhHl5b/5vhbdVlD6FWJiKevQYmYJgcSdtyI2D4j3NwQgrECTzWZxahUWaX
8S+3yTgqdbST6Jo/N/HaN+gvZuSa2AKbp6mR20gbBA0fRI7ReulmV5c0/QtJL4+o
xGBOWz1mVQLlhTWT3RXNAtJGe+9NLFmJ7ASZ6qalNXHVP1T+IpoGTMRD+4yWndGu
rtvJpkxYu+IzyFz2EWOmy1ifPOaF+TipUQkM+piH1f/2Rw2x+LlzJMJttkIoemtI
La3PxSsdxk6c23wXp9lepumbkrf15sdAmzSVNhhSdzqhwiBx4A4=
=4CFO
-----END PGP SIGNATURE-----