[Zope3-dev] RFC: zopeproject
Michael R. Bernstein
michael at fandomhome.com
Wed Aug 1 13:41:37 EDT 2007
On Thu, 2007-07-26 at 23:17 +0200, Philipp von Weitershausen wrote:
> On 18 Jul 2007, at 22:34 , Maciej Wisniowski wrote:
> >> I will add this to the zopeproject docs. I wonder:
> >> * Would it help if the 'myzopeapp' package would not be in the
> >> level MyZopeApp directory, but in a 'src' directory below
> >> MyZopeApp? Would that make it clearer where to go?
> >> * grokproject actually also creates a "hello world" browser page.
> >> That way there's some initial code there and people might know
> >> better where to go in and change stuff. Would that help? Or would
> >> that be too much unnecessary boilerplate?
> > For me, second approach is more clear but even simple README.txt,
> > located at new project's folder, with description of next steps,
> > should be enough.
> The problem with boilerplate README files is that they're never
> changes after the fact, therefore making it look like your code has
> documentation while in fact it's just the unchanged boilerplate. At
> least the code *has* to be changed to make something useful out of
Hmm. Perhaps both sets of requirements can be satisfied by generating a
REPLACEME (or RENAMEME, or EDITME) file with the boilerplate in it. That
should still help a newbie get things going while making it clear that
it is not (yet) actual documentation for the new code.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://mail.zope.org/pipermail/zope3-dev/attachments/20070801/1adcba6e/attachment.bin
More information about the Zope3-dev