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.

Cheers,
Katie

_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

Open Source Applications Foundation "Dev" mailing list
http://lists.osafoundation.org/mailman/listinfo/dev

Reply via email to