On Sat, Jun 06, 2020 06:40:43 -0500, Richard Shaw wrote: > On Sat, Jun 6, 2020 at 5:54 AM Andy Mender <andymenderunix@xxxxxxxxx> wrote: > > Hiya, > > As someone who is trying to get into packaging in Fedora, I would really > really appreciate the docs being less dispersed: > - https://docs.fedoraproject.org/en-US/packaging-guidelines/ > - https://fedoraproject.org/wiki/How_to_create_a_GNU_Hello_RPM_package > - https://rpm-packaging-guide.github.io/ There's a bit of complexity here that makes it hard to put everything in one place: - rpm is a package management system, and it is not specific to Fedora. So the rpm docs, as expected, live outside of Fedora - The packaging guidelines are not "how to build rpms" in my book. They are the list of software development best practices that we follow while building rpms for inclusion in Fedora. So, our guidelines do not apply to other distributions using RPM. So, these live in the Fedora space. I see https://docs.fedoraproject.org/en-US/quick-docs/create-hello-world-rpm/ here, so perhaps the how to on the wiki can be merged there and a redirect set up? Would anyone like to work on this? <- docs contribution opportunity! > Yes, the move to docs.fp.o is frustrating because googling what I need often > points me to the old location and then I have to click the link to get to the > new location. And while the docs site looks "prettier", everything seems to be > "bigger" so it takes more scrolling to find what I need. Quite a few of these are known issues, but the docs team needs more manpower to solve them all. (In fact, the docs team seems to be barely scraping by at the moment) Related tickets and discussion: - adding search functions to docs.fp.o: https://pagure.io/fedora-docs/docs-fp-o/issue/2 - removal of old docs: https://pagure.io/fedora-docs/docs-fp-o/issue/128, https://pagure.io/fedora-docs/docs-fp-o/issue/67, https://pagure.io/fedora-docs/docs-fp-o/issue/30 https://pagure.io/fedora-docs/docs-fp-o/issue/53 https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx/message/CZ7EQ6L7A6AUYDS4J6UMSSI2KL2T6QBC/ So, as with the rest of Fedora, the primary issue here is lack of manpower. I personally don't have a solution to this, but we're trying to get more newbies involved using the Fedora Join SIG: https://pagure.io/fedora-join/Welcome-to-Fedora So if you run into newcomers, please send them to us. If you are community member, please spare some time to help newcomers. From AskFedora too, we try to get "users" to contribute to quick-docs as a gateway to general contribution to Fedora: https://ask.fedoraproject.org/t/optimus-setting-the-nvidia-gpu-as-primary-rpmfusion-in-fedora-32-workstation/6550 -> https://pagure.io/fedora-docs/quick-docs/pull-request/240 -> https://docs.fedoraproject.org/en-US/quick-docs/how-to-set-nvidia-as-primary-gpu-on-optimus-based-laptops/ So, if you do have time, please also keep an eye on AskFedora and suggest easy contribution tasks to "users". Since attracting newcomer to increase our contribution base has always been something we as a community tend to struggle with, this needs a general CommOps/Mindshare/Council level plan perhaps. I don't know. I don't make any proposals to them because I am unable to dedicate the time to work on them myself. (PS: I use "users" because I'm one of those people that do not believe in the "user" "developer" dichotomy in FOSS. It tends to give people outside the community a wrong sense of how we work---they treat us like corporations that provide software and service in return for ... what? So, I prefer to use "community members" for everyone: devs/users/non-dev folks) -- Thanks, Regards, Ankur Sinha "FranciscoD" (He / Him / His) | https://fedoraproject.org/wiki/User:Ankursinha Time zone: Europe/London
Attachment:
signature.asc
Description: PGP signature
_______________________________________________ devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx
