[aur-general] Greetings and Documentation Proposals

[Eli Schwartz]

On 10/7/18 11:41 AM, Brett Cornwall via aur-general wrote:
> Hello, fellow Archers. My name is Brett and I've been making PKGBUILDs
> for the AUR for some time under the moniker 'Ainola'. A number of these
> packages have been kindly pulled into [community] by David Runge. I've
> since had a desire to get some of my other packages into [community], so
> I'm interested in working towards getting TU status.

Well, good luck and maybe one day soon you'll decide the time is ripe to
submit an application. :)

> David has been kind enough to give suggestions to my current packages;
> I'd love to nab some other packages throughout the AUR, improve them,
> and get them included in the repositories for mass consumption.

Great. :) Always nice to have people interested in contributing more. If
you'd like general suggestions, feel free to submit your PKGBUILDs for
review on this mailing list, as I and several other people will be more
than willing to criticize^W^W^W^W^W^W^W^W^Wcritique everything you do. :D

Also make sure to do so before your application, so that once you do
apply, you can pretend your packages are already perfect and therefore
we should all vote for you. :D

> I would also like to improve the documentation for the devtools: There
> are no manpages, /usr/share/docs/ items, or wiki articles. Unless I'm
> mistaken it appears that the only documentation that currently exists is
> just invoking the program with -h. I'd like to fix that. :)

Jelle has submitted several patches to the arch-projects mailing list,
to add manpages to devtools programs.

I'd encourage you to coordinate with him, except for the highly
unfortunate fact that we have 12 people with commit access to devtools,
and 0 people with an *interest* in reviewing patches. (Admittedly this
does include a couple people who are retired or as good as, but it
mostly seems to be people who were very active in devtools... years
ago...) It's simply not worth the investment in time or energy to
attempt to improve devtools except for urgent bugfixes that actually
prevent Devs and TUs from adding packages to the repositories.

I have struggled with this myself.

Sorry. :(

Wiki pages are something you can do without relying on a devtools
maintainer to suddenly materialize and accept your patches. I'd suggest
devoting your efforts there.

-- 
Eli Schwartz
Bug Wrangler and Trusted User

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: OpenPGP digital signature
URL: <https://lists.archlinux.org/pipermail/aur-general/attachments/20181007/5843d9cf/attachment.asc>