I have started a personal project related with ./play.it, but it has gone dormant for a while. I would like to continue it when I find the time (and the stars align).

One thing that hindered me was my lack of knowledge of how packages are supposed to be created. More specifically, their special files with metadata and other details. As a consequence, I feel like I am walking a bit blind through all the code (and projects in the forge), wondering "what does this do?" and "is this related to what I'm trying to accomplish"?

The code is well structured (though how it all comes together took me a while to figure out). The documentation works well on the lower level but I missed the high-level knowledge of what is going on and why each section exists. What I would like to see, to lower the barrier to entry, was a high-level overview of what each section is trying to make (and what they need to do their work). That would facilitate a newbie (such as me) to more easily figure out where I need to make changes and where things may be conflicting with the regular operations. Preferably with some callouts to important functions.

Perhaps this document already exists (or existed when I last looked at this project). If not, perhaps it can be created. I would gladly read it and provide help in improving it since I feel quite qualified as a newbie. (More seriously, I understand that it is difficult to see an outsider's point of view after working on a project so long).