adfinis / pyaptly

Automates the creation and managment of aptly mirrors and snapshots based on yml input files.
GNU Affero General Public License v3.0
16 stars 12 forks source link

docs: Add small how/why and user tutorial #102

Closed Melkor333 closed 6 months ago

Melkor333 commented 8 months ago

I thought writing some user docs is the best way to repeat what I just learned and analyzed :)

Some features are still ignored and publish is not even properly started, but we'll get there.

Melkor333 commented 7 months ago

@ganwell I've tried to get the reasoning for certain design decisions here. But I struggle to see how to go forward. There are a few untouched topics (ie snapshot merging, publish from publish) and the publish section is generally very short (is there more to it? 🤔 ). I think it's OK to not have all use cases here but e.g. in an additional howto's documentation providing snippets similar to the test cases. Or just mention them in a configuration file reference. What do you think?

rhizoome commented 6 months ago

@Melkor333 I'd like to push this. Maybe you can do another iteration with my inputs later.