This is a big one. I was introduced to Max (relatively) long ago, I think it was Max5 (maybe, even Max4?). And one of the most appealing feature of Max at this time was excellent up to date documentation with beautiful interactive examples. Since then Max matured in many ways, but (honestly) I’m totally not satisfied with the current state of Max documentation, which seems to be left in 2008.
Here are the main problems:
1. The documentation is fragmented. Looks like there is nobody at Cycling’74, who is looking at the documentation from an ‘eagle eye’, maintaining the logical overall structure of the docs: the new information is often added without updating the already existing referring pages, docs may appear in unexpected sections etc. (I think it is a very bad sign when you need to point a newbie asking questions to an external resources instead of Max docs). There are good new ideas, which are not supported anymore. For example, in Max 7 docs there was a label ‘Introduced in Max 7.0.0’ which helped users to understand when this feature was introduced. Why this feature is not supported in the following releases for Max 7.* and Max 8.*?
2. The documentation is outdated. Tutorials are often using non efficient and even deprecated objects and techniques. There is an infamous TEXT_HERE placeholder here and there in the docs.
3. Too many typos/broken links/errors. (Personally, I have sent around 100 corrections to the docs to Cycling’74 support). I’m pretty sure there is an urgent need of proof-reading the docs.
And finally: it is exactly a half year since the release of Max 8 and there is still no online Max 8 docs? :-0