[Kss-devel] move doc directory from egg trunk to package root?

[Godefroid Chapelle]

Balazs Ree wrote:
> This is the start of discussion which suggest to move the "doc" 
> subdirectory from the egg root (next to setup.py) to the package root 
> (under kss/core or kss/demo).
> 
> Currently I am against this change. Let me present my reasons.
> 
> The doc directory was placed intentionally to the egg root. The reason 
> for this was that all the other packages in Plone followed this standard, 
> and also that ZopeSkel generates this standard package structure. Also 
> initially when the docs were not yet here, I was asked by Wichert to 
> comply to this convention, and so I did.
> 
> I personally do not see any reason for moving the doc down to the 
> package import root, and have not previously heard any discussion about 
> this. So please, in case you are in favour of this change, go ahead and 
> present your pros!
> 
> Thanks,
> 

The main reason for moving the docs directory is that headers of our 
files mention a CREDITS.txt and a LICENSE.txt.

If we keep the docs directory where it is now, those files are not 
distributed in the egg. IOW, we do not distribute the files with the code.

-- 
Godefroid Chapelle (aka __gotcha) http://bubblenet.be