Re: Initial buildout doc proposed/looking for collaboration

Hello Chris,

You're right on that the buildout tutorial is a bit unfriendly for new 
users and managers. Some people have already raised awareness about the 
unfriendliness you mention: https://dev.plone.org/plone/ticket/9276

Actually, we're (or at least I am) interested in creating a kind of 
"Installation manual", covering the Unified Installer as well as the 
binary installers for Windows and Mac OSX. See 
https://dev.plone.org/plone/ticket/9080

We can add a "Next steps" page at the end of this "Installation manual" 
with quick instructions and links to more elaborated manuals like the 
buildout one. Volunteers appreciated. :)

-- israel



cjj wrote:
> 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


------------------------------------------------------------------------------
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