On Mar 2, 2009, at 11:01 PM, Mathieu Bouchard wrote:
On Sat, 28 Feb 2009, Frank Barknecht wrote:
BTW: That is (and already was in the discussion about it at pd~conv Montreal) my main problem with pdpedia: IMO a Pd doc wiki takes the reference documention too far away from the files.
I agree with that. I used to consider an HTML-based manual as the reference documentation for my externals, but found out it's a real bad idea. It's not just that moving info back and forth from two sets of documentation is long and error-prone, it's also boring and it's something nothing wants to do for free.
This means that unless there are special tools for feeding back info from pdpedia, then pdpedia shouldn't be edited directly, and could even be closed or turned into a bunch of static generated HTML without a CMS behind it; and then all the effort should go towards improving how the helpfiles are to be made and how they are to be interacted with.
(Well, it's also possible to just stop using help files, but 99% of the users would hate it)
pdpedia is not meant to be help patches, instead it is info about the object and things like links to related algorithms, video demos, etc.
.hc
_ _ __ ___ _____ ________ _____________ _____________________ ... | Mathieu Bouchard - tél:+1.514.383.3801, Montréal, Québec_______________________________________________ Pd-dev mailing list Pd-dev@iem.at http://lists.puredata.info/listinfo/pd-dev
----------------------------------------------------------------------------
All information should be free. - the hacker ethic