alexheretic / aurto

Arch Linux AUR tool for managing an auto-updating local 'aurto' package repository
MIT License
134 stars 9 forks source link

[doc] Advanced documentation / add wiki section #53

Open adlerweb opened 3 years ago

adlerweb commented 3 years ago

At the moment most documentation is in README.md. While this is sufficient for most basic stuff it took quite some time to understand how the tools used work together, especially when dealing with GPG or custom repositories. I couldn't really find any advanced documentation for either aurto or aurutils and while the aurto repo would be the place I would look for this first I'm not sure the readme is a good place for this rather specific stuff. Any ideas on how to make this knowledge accessible or easier to find for other aurto users? Maybe enable the wiki section?

Things I have on my notebook:

alexheretic commented 3 years ago

I wouldn't be against a wiki for aurto if that's helpful to people, I've enabled it: https://github.com/alexheretic/aurto/wiki

However, I think the real complexity lies with upstream aurutils & the arch core components, rather than aurto itself. I've tried to keep the scope of this project limited. Generally I'd advise people to use aurutils directly if their requirements outstrip aurto.

aurto uses a dedicated user for most operations

Not exactly right, whichever user that calls aurto init is used to do all non-root tasks. It doesn't have a dedicated user called "aurto" (unless that's been explicitly setup).