Sorry. It got away from me. On Jan 1, 2008 2:11 PM, Edward Cherlin <[EMAIL PROTECTED]> wrote: > On Dec 30, 2007 10:20 AM, C. Scott Ananian <[EMAIL PROTECTED]> wrote: > > I have run the python documentation tool 'epydoc' on the contents of > > the joyride-1477 release. The results are here: > > http://dev.laptop.org/~cscott/joyride-1477-api/ > > Thanks. I was wishing for that. Can you do the other major builds > also? I am running 653, and I keep hearing about Update.1. > > Does anybody know of a documentation tool for Open Firmware, or for > FORTH more generally? Exploring using 'words' and 'see'
is fun up to a point if you're learning FORTH, but really doesn't cut it for supporting documentation. And what about Smalltalk/Etoys? > > This is probably the most up-to-date documentation available now for > > Sugar, the update and contents tools, rainbow, etc. > > I plan to integrate this into the joyride build process, so that there > > are always current API docs available. > > Thank you, thank you. When you can create a URL that will always go to > the latest version, please add it to the Wiki. > > > Comments welcome! And those of you who have not adequately documented > > your code, please do. Module-level comments in particular are very > > helpful, and often missing. > > --scott > > > > -- > > ( http://cscott.net/ ) > > _______________________________________________ > > Devel mailing list > > Devel@lists.laptop.org > > http://lists.laptop.org/listinfo/devel > > http://www.documentia.ca/lies.htm > Biggest Lies Heard by Technical Writers > * You should have a fully-functional product in your hands in plenty > of time to complete your document. > * The product's so intuitive, it practically writes the manual itself. > * You won't be thought of as a nuisance by the SME's. They accept that > you're a peer and respect that you have a job to do. > * I'd make that more abstract. We'll make sure you have everything you > need to get the job done. > * As the tech writer at our company, you will have full, unrestricted > access to the devolopment team's time and resources. > etc. > -- > Edward Cherlin > Earth Treasury: End Poverty at a Profit > http://www.EarthTreasury.org/ > "The best way to predict the future is to invent it."--Alan Kay > -- Edward Cherlin Earth Treasury: End Poverty at a Profit http://www.EarthTreasury.org/ "The best way to predict the future is to invent it."--Alan Kay _______________________________________________ Devel mailing list Devel@lists.laptop.org http://lists.laptop.org/listinfo/devel