Initial buildout doc proposed/looking for collaboration

cjj <[email protected]>
Newsgroups gmane.comp.web.zope.plone.documentation
Message-ID <[email protected]>
Hi all,

I was recently testing Plone 4 (a3) and walking through the process that
hopefully a new person would be seeing. One of the things I noticed is that
after I get it installed, there is a link to how to find out how to
customize the buildout (in the README.txt in zinstances after UI finishes).
It says: 

Customizing the installation
----------------------------
You may control most aspects of your installation, including changing ports
and adding new packages and products by editing the buildout.cfg file in
your instance home at /home/cjohnson/Plone/zinstance.

See Martin Aspelli's excellent tutorial "Managing projects with
zc.buildout":http://plone.org/documentation/tutorial/buildout for
information on buildout options.

Apply settings by running bin/buildout in your instance directory.

While that is a great tutorial, I have tried to use it a few times and found
it rather un-newbie-friendly and instead more oriented towards developers
managing a project using buildout. 

I was thinking to propose a HowTo (customize your new buildout) that we
could point to in initial documentation.  I attempted to write something
along those lines based on my experience helping a friend after install with
UI, which has been one of my more popular posts over the course of the year
(see http://ifpeople.wordpress.com/2009/02/04/after-plone-installe/ and
really the helpful part I forgot to include and put in the comment!). What
do others think?

If there is support for the idea, I'm willing to contribute what I know, but
that's not going to be enough because I don't use Windows (and haven't for
almost a decade), and nor do I use Mac (though Linux knowledge proved enough
to muddle through the experience). So if I can get some help, I'm game :)

Anyway, hope all of you are well and having a great holiday season with lots
of merriment! 

Best wishes,
Chris
--
ifPeople
www.ifpeople.net
t: 678-608-3408




-- 
View this message in context: http://n2.nabble.com/Initial-buildout-doc-proposed-looking-for-collaboration-tp4226137p4226137.html
Sent from the Documentation Team mailing list archive at Nabble.com.

------------------------------------------------------------------------------
This SF.Net email is sponsored by the Verizon Developer Community
Take advantage of Verizon's best-in-class app development support
A streamlined, 14 day to market process makes app distribution fast and easy
Join now and get one step closer to millions of Verizon customers
http://p.sf.net/sfu/verizon-dev2dev
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.