-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 On 2016-12-20 13:51, Marek Marczykowski-Górecki wrote: > On Tue, Dec 20, 2016 at 04:04:20PM -0500, Nicklaus McClendon wrote: >> 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. > > I think separate doc package for man pages was a mistake. But other than > that I agree. > >> 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 <[email protected]> > >
Tracking: https://github.com/QubesOS/qubes-issues/issues/2528 - -- Andrew David Wong (Axon) Community Manager, Qubes OS https://www.qubes-os.org -----BEGIN PGP SIGNATURE----- iQIcBAEBCgAGBQJYWjyWAAoJENtN07w5UDAwpSoQAMy95D5wAVvD3oPpJgRjqDBi zsmFRX0YyO26cVJq1XEdl2UpBXkiCC+sJvXHmECYc1nXxVtpUbqbx3RNtpwQBxRh pl0/BK7BXnqdXqROs8uqGdRHOneJKng0Xwg1x58uxMkp9VUgpsS2trLRfoEguag7 bn8qrm5Pu+HCqI2SUhgST4zCWFB2PSsi6bt7qFLM+1FEOIxqE4QVNMlCApQ1Coi9 okXqJMxw3/L/oxKzcCJtoRaLQwqR7AjDkcsgxznnuRV9oT28nxU8uRXlf5sXwzat IpUpHjVX3YE2Mh20AKcS79k0he9nkX8OLc5I/6yANb4UKqv5xK5nCrjs0qpvSI3Y 338ZIZwMY/fK5kLH3BBNFgArUf0sl98RhoQQ9vB3Qb7e+VDvGNN0M+wNScBwo/7+ LSxD6bbHvj7BONYNff/KlQ8+vu7PPh9K6287mFdvj3r4LFtf3RsIW7f52HH8HnYs CEANw9g1gswPMAJcId2iElvwutrXj0UxEwN8I99El/hKbvYN9dRcEUkkg+I4U1r0 YzpKGQInfjgU1ZGk7Wef/o3kDr9N02ihJMZZzM6Kuzx2r5gbyClBc6cTkTJo4T/v 5qG8O6RiGXHt0pUz0Hzz5e2V/oV6K6rsXXHuSQyMdC8vxhVZU+DnkocWfdq1lJkD 75vRGmb2oVzBzE01bQnD =v4d5 -----END PGP SIGNATURE----- -- You received this message because you are subscribed to the Google Groups "qubes-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/qubes-devel/7648c910-d347-8815-f4fe-aac2e17b4e3c%40qubes-os.org. For more options, visit https://groups.google.com/d/optout.
