Re: New installation instructions

Mikko Ohtamaa <mikko+plone-75aZqqp77KCaMPzRcYMCawC/[email protected]> Sat, 14 Apr 2012 00:46:47 +0300
Newsgroups gmane.comp.web.zope.plone.documentation
Message-ID <CAK8RCUsPD1xJzLfn9r5y2g+u6hichhv+T1BbZhZ4_Dcnzdf0zg@mail.gmail.com>
--===============6666681590391210256==
Content-Type: multipart/alternative; boundary=20cf3074ba56caf45404bd9668c7

--20cf3074ba56caf45404bd9668c7
Content-Type: text/plain; charset=ISO-8859-1

On Fri, Apr 13, 2012 at 23:42, John Schinnerer <john-/Gao9/[email protected]> wrote:

> I am totally new to github...the apparently relevant button says "Fork and
> Edit this file" - not sure if that is the correct thing to do? Please
> advise how to make the edit without making a mess...
>

Should go like this


   1. Go to Writing and updating the documentation
   <https://github.com/collective/collective.developermanual/edit/master/source/introduction/writing.rst>on
GitHub.
   2. Press *Fork and edit this file* button
   3. Edit file contents using GitHub's text editor in your web browser
   4. Press *Propose file change* at the bottom of the page




>
> thanks,
> John S.
>
>
> On 04/12/2012 08:56 PM, Mikko Ohtamaa wrote:
>
>> Hi John,
>>
>>    Mention early on, with link, to see the Hosting Guide for information
>>    about production installations/deployments.
>>
>>
>> Good spot. Can you go ahead and fix it directly here?
>>
>> https://github.com/collective/**collective.developermanual/**
>> blob/master/source/tutorials/**installation.rst<https://github.com/collective/collective.developermanual/blob/master/source/tutorials/installation.rst>
>>
>> -Mikko
>>
>>    For example where it now says:
>>
>>    ------------------------------**----------
>>    ...
>>    Installing Plone using Unified UNIX Installer
>>
>>    Note
>>    This is the recommended installation method
>>
>>    This recipe is good for
>>         Lightweight production sites
>>         Plone development and testing on Ubuntu / Debian
>>    ...
>>    ------------------------------**------------
>>
>>    ...add some following text like:
>>
>>    "For information on using this installation with production
>>    environments/deployments, see the [hosting guide]."
>>
>>    There is a line that hints at that at the very end of the unified
>>    installer section, and I think it could be clearer and sooner.
>>
>>    thanks,
>>    John S.
>>
>>    On 04/10/2012 05:04 AM, Mikko Ohtamaa wrote:
>>     > Hi,
>>     >
>>     > I try to modernize / centralize existing Plone installation
>>    instructions.
>>     >
>>     > Please take a look on:
>>     >
>>     >
>>    http://collective-docs.**readthedocs.org/en/latest/**
>> tutorials/installation.html<http://collective-docs.readthedocs.org/en/latest/tutorials/installation.html>
>>     >
>>     > ...and then take a stab on the document or me.
>>     >
>>     > Cheers,
>>     > Mikko
>>     >
>>     > -----
>>     >
>>     > Follow me in Twitter
>>     >
>>     >
>>     >
>>     > Read my blog
>>     >
>>     >
>>     >
>>     >
>>     >
>>     > --
>>     > View this message in context:
>>    http://plone.293351.n2.nabble.**com/New-installation-**instructions-**
>> tp7453156p7453156.html<http://plone.293351.n2.nabble.com/New-installation-instructions-tp7453156p7453156.html>
>>     > Sent from the Documentation Team mailing list archive at Nabble.com.
>>     >
>>     >
>>    ------------------------------**------------------------------**
>> ------------------
>>     > Better than sec? Nothing is better than sec when it comes to
>>     > monitoring Big Data applications. Try Boundary one-second
>>     > resolution app monitoring today. Free.
>>     > http://p.sf.net/sfu/Boundary-**dev2dev<http://p.sf.net/sfu/Boundary-dev2dev>
>>     > ______________________________**_________________
>>     > Plone-docs mailing list
>>     > [email protected]**net<[email protected]>
>>    <mailto:Plone-docs@lists.**sourceforge.net<[email protected]>
>> >
>>
>>     > https://lists.sourceforge.net/**lists/listinfo/plone-docs<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
>>    john-/Gao9/[email protected] <mailto:john-/Gao9/[email protected]>
>>
>>    http://eco-living.net
>>
>>    ------------------------------**------------------------------**
>> ------------------
>>    For Developers, A Lot Can Happen In A Second.
>>    Boundary is the first to Know...and Tell You.
>>    Monitor Your Applications in Ultra-Fine Resolution. Try it FREE!
>>    http://p.sf.net/sfu/Boundary-**d2dvs2<http://p.sf.net/sfu/Boundary-d2dvs2>
>>    ______________________________**_________________
>>    Plone-docs mailing list
>>    [email protected]**net <[email protected]>
>>    <mailto:Plone-docs@lists.**sourceforge.net<[email protected]>
>> >
>>
>>    https://lists.sourceforge.net/**lists/listinfo/plone-docs<https://lists.sourceforge.net/lists/listinfo/plone-docs>
>>
>>    --
>>    Mikko Ohtamaa
>>    http://opensourcehacker.com
>>    http://twitter.com/moo9000
>>
>>
>>
>>
> --
> John Schinnerer - M.A., Whole Systems Design
> ------------------------------**--------------
> - Eco-Living -
> Whole Systems Design Services
> People - Place - Learning - Integration
> john-/Gao9/[email protected]
> http://eco-living.net
>
> --
> Mikko Ohtamaa
> <http://eco-living.net>http://opensourcehacker.com
> http://twitter.com/moo9000
>
>
>
>

--20cf3074ba56caf45404bd9668c7
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

<br><br><div class=3D"gmail_quote">On Fri, Apr 13, 2012 at 23:42, John Schi=
nnerer <span dir=3D"ltr">&lt;<a href=3D"mailto:john-/Gao9/[email protected]">john@ec=
o-living.net</a>&gt;</span> wrote:<br><blockquote class=3D"gmail_quote" sty=
le=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I am totally new to github...the apparently relevant button says &quot;Fork=
 and Edit this file&quot; - not sure if that is the correct thing to do? Pl=
ease advise how to make the edit without making a mess...<br></blockquote>
<div><br>Should go like this<br><br><p>

      </p><ol><li>
          Go to=20
        <a href=3D"https://github.com/collective/collective.developermanual=
/edit/master/source/introduction/writing.rst">
          Writing and updating the documentation
        </a> on GitHub.
      </li><li>
          Press <b>Fork and edit this file</b> button
      </li><li>
          Edit file contents using GitHub&#39;s text editor in your web bro=
wser
      </li><li>
        Press <b>Propose file change</b> at the bottom of the page
      </li></ol>

      <br>=A0</div><blockquote class=3D"gmail_quote" style=3D"margin:0pt 0p=
t 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
thanks,<br>
John S.<div><div class=3D"h5"><br>
<br>
On 04/12/2012 08:56 PM, Mikko Ohtamaa wrote:<br>
</div></div><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;bo=
rder-left:1px #ccc solid;padding-left:1ex"><div><div class=3D"h5">
Hi John,<br>
<br>
 =A0 =A0Mention early on, with link, to see the Hosting Guide for informati=
on<br>
 =A0 =A0about production installations/deployments.<br>
<br>
<br>
Good spot. Can you go ahead and fix it directly here?<br>
<br>
<a href=3D"https://github.com/collective/collective.developermanual/blob/ma=
ster/source/tutorials/installation.rst" target=3D"_blank">https://github.co=
m/collective/<u></u>collective.developermanual/<u></u>blob/master/source/tu=
torials/<u></u>installation.rst</a><br>

<br>
-Mikko<br>
<br>
 =A0 =A0For example where it now says:<br>
<br>
 =A0 =A0------------------------------<u></u>----------<br>
 =A0 =A0...<br>
 =A0 =A0Installing Plone using Unified UNIX Installer<br>
<br>
 =A0 =A0Note<br>
 =A0 =A0This is the recommended installation method<br>
<br>
 =A0 =A0This recipe is good for<br>
 =A0 =A0 =A0 =A0 Lightweight production sites<br>
 =A0 =A0 =A0 =A0 Plone development and testing on Ubuntu / Debian<br>
 =A0 =A0...<br>
 =A0 =A0------------------------------<u></u>------------<br>
<br>
 =A0 =A0...add some following text like:<br>
<br>
 =A0 =A0&quot;For information on using this installation with production<br=
>
 =A0 =A0environments/deployments, see the [hosting guide].&quot;<br>
<br>
 =A0 =A0There is a line that hints at that at the very end of the unified<b=
r>
 =A0 =A0installer section, and I think it could be clearer and sooner.<br>
<br>
 =A0 =A0thanks,<br>
 =A0 =A0John S.<br>
<br>
 =A0 =A0On 04/10/2012 05:04 AM, Mikko Ohtamaa wrote:<br>
 =A0 =A0 &gt; Hi,<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; I try to modernize / centralize existing Plone installation<b=
r>
 =A0 =A0instructions.<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; Please take a look on:<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0<a href=3D"http://collective-docs.readthedocs.org/en/latest/tutoria=
ls/installation.html" target=3D"_blank">http://collective-docs.<u></u>readt=
hedocs.org/en/latest/<u></u>tutorials/installation.html</a><br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; ...and then take a stab on the document or me.<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; Cheers,<br>
 =A0 =A0 &gt; Mikko<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; -----<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; Follow me in Twitter<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; Read my blog<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt; --<br>
 =A0 =A0 &gt; View this message in context:<br>
 =A0 =A0<a href=3D"http://plone.293351.n2.nabble.com/New-installation-instr=
uctions-tp7453156p7453156.html" target=3D"_blank">http://plone.293351.n2.na=
bble.<u></u>com/New-installation-<u></u>instructions-<u></u>tp7453156p74531=
56.html</a><br>

 =A0 =A0 &gt; Sent from the Documentation Team mailing list archive at Nabb=
le.com.<br>
 =A0 =A0 &gt;<br>
 =A0 =A0 &gt;<br>
 =A0 =A0------------------------------<u></u>------------------------------=
<u></u>------------------<br>
 =A0 =A0 &gt; Better than sec? Nothing is better than sec when it comes to<=
br>
 =A0 =A0 &gt; monitoring Big Data applications. Try Boundary one-second<br>
 =A0 =A0 &gt; resolution app monitoring today. Free.<br>
 =A0 =A0 &gt; <a href=3D"http://p.sf.net/sfu/Boundary-dev2dev" target=3D"_b=
lank">http://p.sf.net/sfu/Boundary-<u></u>dev2dev</a><br>
 =A0 =A0 &gt; ______________________________<u></u>_________________<br>
 =A0 =A0 &gt; Plone-docs mailing list<br>
 =A0 =A0 &gt; <a href=3D"mailto:[email protected]" target=3D=
"_blank">[email protected]<u></u>net</a><br></div></div>
 =A0 =A0&lt;mailto:<a href=3D"mailto:[email protected]" targ=
et=3D"_blank">Plone-docs@lists.<u></u>sourceforge.net</a>&gt;<div class=3D"=
im"><br>
 =A0 =A0 &gt; <a href=3D"https://lists.sourceforge.net/lists/listinfo/plone=
-docs" target=3D"_blank">https://lists.sourceforge.net/<u></u>lists/listinf=
o/plone-docs</a><br>
<br>
 =A0 =A0--<br>
 =A0 =A0John Schinnerer - M.A., Whole Systems Design<br>
 =A0 =A0------------------------------<u></u>--------------<br>
 =A0 =A0- Eco-Living -<br>
 =A0 =A0Whole Systems Design Services<br>
 =A0 =A0People - Place - Learning - Integration<br></div>
 =A0 =A0<a href=3D"mailto:john-/Gao9/[email protected]" target=3D"_blank">john@eco-l=
iving.net</a> &lt;mailto:<a href=3D"mailto:john-/Gao9/[email protected]" target=3D"_=
blank">john-/Gao9/[email protected]</a>&gt;<div class=3D"im"><br>
 =A0 =A0<a href=3D"http://eco-living.net" target=3D"_blank">http://eco-livi=
ng.net</a><br>
<br>
 =A0 =A0------------------------------<u></u>------------------------------=
<u></u>------------------<br>
 =A0 =A0For Developers, A Lot Can Happen In A Second.<br>
 =A0 =A0Boundary is the first to Know...and Tell You.<br>
 =A0 =A0Monitor Your Applications in Ultra-Fine Resolution. Try it FREE!<br=
>
 =A0 =A0<a href=3D"http://p.sf.net/sfu/Boundary-d2dvs2" target=3D"_blank">h=
ttp://p.sf.net/sfu/Boundary-<u></u>d2dvs2</a><br>
 =A0 =A0______________________________<u></u>_________________<br>
 =A0 =A0Plone-docs mailing list<br>
 =A0 =A0<a href=3D"mailto:[email protected]" target=3D"_blan=
k">[email protected]<u></u>net</a><br></div>
 =A0 =A0&lt;mailto:<a href=3D"mailto:[email protected]" targ=
et=3D"_blank">Plone-docs@lists.<u></u>sourceforge.net</a>&gt;<div class=3D"=
im"><br>
 =A0 =A0<a href=3D"https://lists.sourceforge.net/lists/listinfo/plone-docs"=
 target=3D"_blank">https://lists.sourceforge.net/<u></u>lists/listinfo/plon=
e-docs</a><br>
<br>
 =A0 =A0--<br>
 =A0 =A0Mikko Ohtamaa<br>
 =A0 =A0<a href=3D"http://opensourcehacker.com" target=3D"_blank">http://op=
ensourcehacker.com</a><br>
 =A0 =A0<a href=3D"http://twitter.com/moo9000" target=3D"_blank">http://twi=
tter.com/moo9000</a><br>
<br>
<br>
<br>
</div></blockquote><div class=3D"HOEnZb"><div class=3D"h5">
<br>
-- <br>
John Schinnerer - M.A., Whole Systems Design<br>
------------------------------<u></u>--------------<br>
- Eco-Living -<br>
Whole Systems Design Services<br>
People - Place - Learning - Integration<br>
<a href=3D"mailto:john-/Gao9/[email protected]" target=3D"_blank">john-/Gao9/[email protected]=
t</a><br>
<a href=3D"http://eco-living.net" target=3D"_blank">http://eco-living.net<b=
r clear=3D"all"><br>-- <br>Mikko Ohtamaa<br></a><a href=3D"http://opensourc=
ehacker.com" target=3D"_blank">http://opensourcehacker.com</a><br><a href=
=3D"http://twitter.com/moo9000" target=3D"_blank">http://twitter.com/moo900=
0</a><br>
<br>
<br><br>
</div></div></blockquote></div>

--20cf3074ba56caf45404bd9668c7--


--===============6666681590391210256==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

------------------------------------------------------------------------------
For Developers, A Lot Can Happen In A Second.
Boundary is the first to Know...and Tell You.
Monitor Your Applications in Ultra-Fine Resolution. Try it FREE!
http://p.sf.net/sfu/Boundary-d2dvs2
--===============6666681590391210256==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
Plone-docs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/plone-docs

--===============6666681590391210256==--