Messed documentation...
|
ragd3
Joined: 2008-08-10
Posts: 5 |
Posted: Thu, 2008-08-14 04:03
|
|
Hi, I wanted to go beyond and integrate gallery directly to websites... I've been reading a lot and I'm getting the feeling I'm goind somewhere... however, I think there is a mess of information in the Gallery Codex and apidocs which makes things complicated. Altough there is huge information some topics lacks of details, but the worst part is that there are some features (methods, parameters, etc.) documented but when you try to used them they don't work, because they are new features of not-yet-officially-released versions or are already deprecated and you only realize this when you've spent a while trying to figure out what's going on... very frustrating! for example: In the same document method getImageBlock says "Deprecated: Use getBlock() instead", I tried to use getBlock() until I found out this doen't apply to 2.2... - and so on... also, the codex site is very useful but very messy sometimes... I believe documentation should be classified/organized in a better way, because there is so much information but also so many changes with every minor/major update that it makes it very prone to confusion... Just to let you know. Take care, keep the good work! |
|
Posts: 32509
> I believe documentation should be classified/organized in a better way,
true, that would be the best solution.
until we can provide that, please help improve the docs. it's a wiki, you can edit it any time. if you think a comment would be helpful, e.g. "this method is has been added in Gallery 2.3, prior versions should use ...", please add it.
thanks!
--------------
Documentation: Support / Troubleshooting | Installation, Upgrade, Configuration and Usage
Posts: 5
Hey! that's a good idea!
Thank you!