At 10:00 AM 12/13/2005 -0800, Katie Capps Parlante wrote:
Jeffrey Harris wrote:
Hi Katie,
I noticed foo.bar.yyy.zzz syntax to describe code locations in
overview.html, as opposed to using slashes. This is fine, but I think
it might lead to significant confusion for beginning developers, because
this syntax alludes to Python package notation. This, in turn, is
potentially a problem because parcels is not a package, so while you can
execute:
import application.dialogs
you can't run
import parcels.osaf.views.main
you have to say
import osaf.views.main
I'm not sure if you should change your notation, note this idiosyncrasy
explicitly, or just not worry about it. :)
Good point. Should we just use slashes? In the long run, I think we hope
to move away this whole "parcels" subdirectory. In the short run, the
intent is to point people at where to look if they want to go poking
around the code.
I suggest using *both*, e.g.:
parcels/osaf/views/main (the osaf.views.main package)
or:
osaf.views.main (parcels/osaf/views/main directory)
as this will help people deal better with the current directory structure.
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Open Source Applications Foundation "Dev" mailing list
http://lists.osafoundation.org/mailman/listinfo/dev
