[Plone-docs] Initial buildout doc proposed/looking for collaboration

[cjj]

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

[Anne Bowtell]

Good idea! I'd be happy to comment on drafts.

Anne

Post by cjj
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).
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

[Israel Saeta Pérez]

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

Post by cjj
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).
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

[Martin Aspeli]

Post by cjj
See Martin Aspelli's

*cough* *Aspeli* *cough*

Post by cjj
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.

That is probably a fair statement. I think we've mainly expected "new"
users to start with the installers. Now that the installers are buildout
based (they weren't when I wrote that tutorial), documentation on how to
customise them seems in order.

Martin

[Alexander Limi]

On Tue, Dec 29, 2009 at 4:42 PM, Martin Aspeli

Post by Martin Aspeli

Post by cjj
See Martin Aspelli's

*cough* *Aspeli* *cough*

Just submit a patch to change aspell <http://aspell.net/>'s command line
invocation to be "aspel", and you'll never see that mis-spelling again. ;)

[Alex Clark]

--===============8161707868871754334==
Content-Type: multipart/alternative; boundary=000e0cd694d61462e1047beb4f22
--000e0cd694d61462e1047beb4f22
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
On Tue, Dec 29, 2009 at 4:42 PM, Martin Aspeli

Post by Martin Aspeli

Post by cjj
See Martin Aspelli's

*cough* *Aspeli* *cough*

Just submit a patch to change aspell <http://aspell.net/>'s command line
invocation to be "aspel", and you'll never see that mis-spelling again. ;)

Kudos to Martin for always fighting the (seemingly uphill) battle of trying to get people to spell his name right! ;-)

--=20
Alexander Limi =B7 http://limi.net
--000e0cd694d61462e1047beb4f22
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
On Tue, Dec 29, 2009 at 4:42 PM, Martin Aspeli <span dir=3D"ltr">&lt;<a hre=
pan> wrote:<br><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote"=
style=3D"margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 2=
04); padding-left: 1ex;">
cjj wrote:<br>
<br>
&gt; See Martin Aspelli&#39;s<br>
<br>
*cough* *Aspeli* *cough*<br></blockquote><div><br><br></div></div>Just subm=
it a patch to change <a href=3D"http://aspell.net/">aspell</a>&#39;s comman=
d line invocation to be &quot;aspel&quot;, and you&#39;ll never see that mi=
s-spelling again. ;)<br clear=3D"all">
<br>-- <br>Alexander Limi =B7 <a href=3D"http://limi.net">http://limi.net</=
a><br>
--000e0cd694d61462e1047beb4f22--
--===============8161707868871754334==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
------------------------------------------------------------------------------
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
--===============8161707868871754334==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
_______________________________________________
Plone-docs mailing list
https://lists.sourceforge.net/lists/listinfo/plone-docs
--===============8161707868871754334==--

[Alex Clark]

FTR, this is essentially what my book aims to do. Unfortunately, it will
probably be marketed for Plone 3, but the message of "this is how you get
things done with buildout" applies to future versions (in practice, if not
in marketing).

Post by cjj
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).
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

[cjj]

Hi folks,

Inspired by the tuneup day, I created a first draft. I'm not sure how perms
work on the docs section, so hopefully you can see it. Check it out here:

http://plone.org/documentation/kb/adding-products-to-your-new-plone-site

Note: I don't know what style people use to highlight code generally, so
that's missing.

-chris

Post by Alex Clark
FTR, this is essentially what my book aims to do. Unfortunately, it will
probably be marketed for Plone 3, but the message of "this is how you get
things done with buildout" applies to future versions (in practice, if not
in marketing).

Post by cjj
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).
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

--
---
Alex Clark · http://aclark.net
Practical Plone 3 · http://tinyurl.com/practical-plone
------------------------------------------------------------------------------
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
_______________________________________________
Plone-docs mailing list
https://lists.sourceforge.net/lists/listinfo/plone-docs

[John Schinnerer]

Aloha,

Thanks, and...I get 'insufficient priveleges' trying to check this out...

cheers,
John S.

Post by cjj
Hi folks,
Inspired by the tuneup day, I created a first draft. I'm not sure how perms
http://plone.org/documentation/kb/adding-products-to-your-new-plone-site
Note: I don't know what style people use to highlight code generally, so
that's missing.
-chris

Post by Alex Clark
FTR, this is essentially what my book aims to do. Unfortunately, it will
probably be marketed for Plone 3, but the message of "this is how you get
things done with buildout" applies to future versions (in practice, if not
in marketing).

Post by cjj
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).
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

--
---
Alex Clark · http://aclark.net
Practical Plone 3 · http://tinyurl.com/practical-plone
------------------------------------------------------------------------------
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
_______________________________________________
Plone-docs mailing list
https://lists.sourceforge.net/lists/listinfo/plone-docs

[cjj]

Hey sorry, John. I just submitted it.
-c

On Sat, Jan 16, 2010 at 3:38 PM, John Schinnerer [via Plone] <

Post by John Schinnerer
Aloha,
Thanks, and...I get 'insufficient priveleges' trying to check this out...
cheers,
John S.

Post by cjj
Hi folks,
Inspired by the tuneup day, I created a first draft. I'm not sure how

perms

Post by cjj
http://plone.org/documentation/kb/adding-products-to-your-new-plone-site
Note: I don't know what style people use to highlight code generally, so
that's missing.
-chris

Post by Alex Clark
FTR, this is essentially what my book aims to do. Unfortunately, it will
probably be marketed for Plone 3, but the message of "this is how you

get

Post by cjj

Post by Alex Clark
things done with buildout" applies to future versions (in practice, if

not

Post by cjj

Post by Alex Clark
in marketing).
On 2009-12-29, cjj <[hidden email]<http://n2.nabble.com/user/SendEmail.jtp?type=node&node=4405791&i=0>>

Post by cjj
Hi all,
I was recently testing Plone 4 (a3) and walking through the process

that

Post by cjj

Post by Alex Clark

Post by cjj
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).
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

Post by cjj

Post by Alex Clark

Post by cjj
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

Post by cjj

Post by Alex Clark

Post by cjj
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

Post by cjj

Post by Alex Clark

Post by cjj
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,

Post by cjj

Post by Alex Clark

Post by cjj
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

:)

Post by cjj

Post by Alex Clark

Post by cjj
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

--
---
Alex Clark · http://aclark.net
Practical Plone 3 · http://tinyurl.com/practical-plone

------------------------------------------------------------------------------

Post by cjj

Post by Alex Clark
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
_______________________________________________
Plone-docs mailing list
[hidden email]<http://n2.nabble.com/user/SendEmail.jtp?type=node&node=4405791&i=1>
https://lists.sourceforge.net/lists/listinfo/plone-docs

--
John Schinnerer - M.A., Whole Systems Design
--------------------------------------------
- Eco-Living -
Whole Systems Design Services
People - Place - Learning - Integration
[hidden email]<http://n2.nabble.com/user/SendEmail.jtp?type=node&node=4405791&i=2>
http://eco-living.net
------------------------------------------------------------------------------
Throughout its 18-year history, RSA Conference consistently attracts the
world's best and brightest in the field, creating opportunities for
Conference
attendees to learn about information security's most important issues
through
interactions with peers, luminaries and emerging and established companies.
http://p.sf.net/sfu/rsaconf-dev2dev
_______________________________________________
Plone-docs mailing list
[hidden email]<http://n2.nabble.com/user/SendEmail.jtp?type=node&node=4405791&i=3>
https://lists.sourceforge.net/lists/listinfo/plone-docs
------------------------------
http://n2.nabble.com/Initial-buildout-doc-proposed-looking-for-collaboration-tp4226137p4405791.html
To unsubscribe from Re: Initial buildout doc proposed/looking for
collaboration, click here< (link removed) =>.

--
Cofounder and CEO
ifPeople - Innovation for People
t: 678-608-3408 x16
www.ifpeople.net

** Check out our upcoming trainings! Engagement, online fundraising, a Plone
demo or leading tools for integrating your websites with salesforce.com CRM:
http://www.ifpeople.net/learn/training **

[Israel Saeta Pérez]

Post by cjj
Hi folks,
Inspired by the tuneup day, I created a first draft. I'm not sure how perms
http://plone.org/documentation/kb/adding-products-to-your-new-plone-site
Note: I don't know what style people use to highlight code generally, so
that's missing.
-chris

Thanks Chris!

I still need to figure out what's the best place to put this doc in our
manuals, since I think that a clear howto on adding products is a vital
piece of documentation we should actively maintain.

-- israel