Re: [Pyobjc-dev] notes on Examples/

[Ronald O. <ous...@ci...>]

On Monday, Jun 9, 2003, at 10:26 Europe/Amsterdam, Just van Rossum 
wrote:

> I think it would be useful to add my ClassBrowser and PythonBrowser
> examples to the Examples directory. PythonBrowser's use of 
> NSOutlineView
> is quite different from iClass, and we currently don't have any demo's
> for NSBrowser. Another example that has helped me a lot in the past is
> Etienne Posthumus Pythonized DotView example. I would be willing to 
> make
> that one ready for Examples/, too.
>
> I am aware that we won't ever be able to get full coverage of the Cocoa
> frameworks, but simple examples of often needed UI elements can be
> extremely helpful for people starting with PyObjC.

Adding these is fine with me. We currently have to few usefull examples.

>
> We could also do some cleaning-up: at least TableModel2 is redundant, 
> as
> WebServicesTool already demonstrates (among many other things -- it's a
> truly great demo!) how to build Cocoa-Python apps with ProjectBuilder
> quite well. (TableModel and TableModel2 are already quite out of sync,
> which is basically why I bring this up.)

Having two almost identical examples is not very usefull, TableModel2 
should be removed. It might be usefull to add project-builder projects 
to every example, but we then have to find a volunteer to keep these 
up-to-date.

>
> Another useful change would be the incorporation of
> Examples/00ReadMe.txt into the HTML docs. Perhaps this can even be
> automated if we convert that file to reST.

I'd like to add the examples to the website, but haven't really thought 
on how to do this. We could add HTML files with pretty-printed source 
files and a link to an archive containing the sources for the example.

Automaticly converting the readme to HTML would be trivial if it were 
written in ReST.

Ronald