I think one challenge is that we have alot of different initiatives and it’s hard to know where we should put our energy . Things work alot better when we are all in one place but harder when distributed. We start alot of things and don’t finish them which makes it hard, there’s 3-4 incomplete places for documentation and better would be one place done well. I feel like we’ve always had trouble with this.
Overall I feel like OF book is pretty helpful but it was a ton of work to wrangle chapters and alot of them are a bit long, where it makes sense to keep things light. I feel like it’s overall pretty helpful and my students like it. I did take the denver conference to finish it and I feel like we can add small chapters but I would suggest we don’t spend much more energy on it, it feels the most done of all the documentation efforts.
I personally feel like the most important thing (since I teach alot of beginners) is a minimal API – something like:
which give beginners a leg up in getting a sense of OF – the most common things you need to do like draw shapes, load images, etc. I feel like this is something that could be off the main documentation somehow but organized nicely and friendly in the way p5 doc is friendly. This would skip alot of material – just focus on the most important parts of the api that an intro student would need. (ofSetColor, etc)
Second, would be some organizational work to make the documentation more friendly. Even just grouping vs alphabetical order can help functions make sense – for example
could be next to each other. It makes it easier to grok all the color related stuff.
I think it would be helpful for doing completeness on the docs and one way is to maybe have people “adopt” a class and maintain the documentation for that class, they way for example on the highway you see people adopt a section of the highway. There’s alot of work to be done but if it’s split up and different people take on a specific task it can work well. OF book worked because people took on a small manageable thing – they new they were focused just on sound or just on game design. That helps a TON to make it feel like it’s a task that can be done. It still takes work but it’s much easier that way.