On Thursday 09 April 2009 23:14:28 Frank Barknecht wrote: > Hallo, > > dmotd hat gesagt: // dmotd wrote: > > i am not at all convinced that pdpedia/mediawiki serves as a > > good method for object reference. it is difficult to maintain > > (a lot of manual copy and paste), its search/sort functionality > > is limited, the up/down stream api is severely lacking and most > > of all it is difficult to integrate it into a pd environment > > (outside of simple pddp links which are usually inside the > > object reference anyhow). > > I believe, reference documentation belongs into the code and > additional display methods should be generated from that. What's > currently useful in pdpedia mostly was generated by a script, but > a year or so ago and it may already be outdated or referring to > objects not available anymore (i.e. > http://wiki.puredata.info/en/mapping/degrees0x2d0x3emapping) > > Ciao
hey frank, yes this is exactly my point, though pd is not the first language to find methods referenced in documentation are severely outdated. and pd is not a text-based language, so text based documentation is already a hurdle. what i am interested in developing is a wiki that incorporates the pd patcher paradigm, so that reference material and examples can be submitted as pd-code. how this is dismantled and presented in text w/ diagrams is irrelevant as long as the folks looking at a text based reference understand that a greater depth to the same reference exists within pd. hopefully something a little more personalised to the pd project can come from these qualms/observations :) cheers, dmotdf _______________________________________________ Pd-list@iem.at mailing list UNSUBSCRIBE and account-management -> http://lists.puredata.info/listinfo/pd-list