Provide development documentation
docs/
contains user manuals, but short of that, development documentation seems absent.
@ariadne wrote interesting analyses such as https://ariadne.space/2021/10/31/spelunking-through-the-apk-tools-dependency-solver/, which I think deserve a more central place.
In addition, personally, I'd like to learn about apk-tools
's design principles and architectural requirements. For example, is /var/cache/apk/
supposed to be data race safe in the face of parallel apk
processes?