It's just a regular Mezzanine project - there aren't any special instructions.
On Sun, May 24, 2015 at 3:08 PM, Graham <greenbay.gra...@gmail.com> wrote: > Thanks Brandon > I will get going with the feedback I have. > Stephen, could you please give me the instructions on how to install the > 'project site' on my local development machine. > I can do the git clone but I am a bit hazy after that. > Thanks > g > > > On 24/05/15 21:41, Brandon Keith Biggs wrote: > > Hello, > I believe most people who read the readme on github have already seen the > website. > So they would like to know technical stuff and how to get started and do > basic and essential things. > Perhaps a link to Dgango's guide and then instructions on how to get > started and instructions on how to deploy. > thanks, > > Brandon Keith Biggs <http://www.brandonkeithbiggs.com/> > On 5/24/2015 11:20 AM, Graham wrote: > > Hello all... > I am also interested in the 'who' and the 'why' and this may help us > decide what should go in the README... > > *Who* are we designing the README for? > *Why* would the reader of the README choose to become involved, what would > 'hook them in'? > *Why* choose Mezzanine over any other 'similar' project? > *Who* would we like to attract to the project / to use Mezzanine? > Is there a minimum skill level that we want to mention? > > Clearly I have my own responses to these questions, but interested to hear > others points of view before I unduly influence anyone! > > Cheers > g > > > On 24/05/15 05:40, Stephen McDonald wrote: > > > > On Fri, May 22, 2015 at 11:14 PM, Mathias Ettinger < > mathias.ettin...@gmail.com> wrote: > >> Why not swap it entirely with doc/overview.rst? >> > > I think this will be the general approach - move stuff out of the > README, and directly into the docs, and adding links in the README back to > the docs for these moved pieces. > > Here's my initial thoughts on each section, feedback welcome. > > Overview -> leave as is > Features -> leave as is > Dependencies -> move to end of "installation" section > Installation -> move to "overview" in docs, and link from README > Themes -> move to "overview" in docs, no link needed from README > Browser support -> move to "overview" in docs, no link needed from README > Contributing -> leave as is > Multi-lingual sites -> already has a docs section, merge into that or > remove > Third party plugins -> move to "overview" in docs, and link from README > Donating -> leave as is > Support -> leave as is, but move up to a more prominent spot (the number > of invalid issues opened when posting to the mailing list would suffice is > overwhelming) > Sites using Mezzanine -> move to "overview" in docs, and link from README > (refactoring demo site required) > Quotes -> leave as is > > > > > > > >> >> This way, what relies on README.rst today can rely on overview.rst >> tomorow without breaking anything. Or is the point to shorten both? >> >> >> Le vendredi 22 mai 2015 22:32:01 UTC+2, Stephen McDonald a écrit : >>> >>> It's a good idea. >>> >>> Please keep in mind there's some functionality of the project site >>> dependent on the format of the readme, particularly those lists we'll >>> probably remove: >>> >>> >>> https://github.com/stephenmcd/mezzanine.jupo.org/blob/master/demo/__init__.py >>> >>> On Fri, May 22, 2015 at 1:26 PM, Geo <djge...@gmail.com> wrote: >>> >>>> +1 >>>> >>>> Mezzanine's Readme is, at the time of writing, 795 lines long - pretty >>>> much an essay! The GH Readme for Django itself is short and sweet at just >>>> 44 lines. That's a massive 94% reduction in lines. >>>> >>>> If you are looking for a python CMS to use, you want to read about 3 >>>> key features of Mezzanine that make it stand out from all the others, >>>> that's all. Then one could link to the Mezzanine website and documentation >>>> website for further details and even for installation steps etc. >>>> >>>> Just my thoughts. Interesting to hear what the core devs think... >>>> >>>> >>>> On Friday, 22 May 2015 10:43:37 UTC+1, Graham Oliver wrote: >>>>> >>>>> Hi all >>>>> I would like to have a go at revamping the readme on GitHub >>>>> https://github.com/stephenmcd/mezzanine/blob/master/README.rst >>>>> >>>>> Initial thoughts >>>>> - Make it way shorter >>>>> - Put the 'third party plugins' and 'sites using Mezzanine' lists in >>>>> separate documents >>>>> - Add details of 'Core Development Team' >>>>> >>>>> Possibly also something for people (relatively) new to the Open Source >>>>> thing..... >>>>> >>>>> All feedback appreciated... >>>>> >>>>> This one I quite like (apart from the crypto stuff) >>>>> http://svn.apache.org/repos/asf/httpd/httpd/trunk/README >>>>> >>>>> Take Care >>>>> g >>>>> >>>>> -- >>>> You received this message because you are subscribed to the Google >>>> Groups "Mezzanine Users" group. >>>> To unsubscribe from this group and stop receiving emails from it, send >>>> an email to mezzanine-use...@googlegroups.com. >>>> For more options, visit https://groups.google.com/d/optout. >>>> >>> >>> >>> >>> -- >>> Stephen McDonald >>> http://jupo.org >>> >> -- >> You received this message because you are subscribed to the Google Groups >> "Mezzanine Users" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to mezzanine-users+unsubscr...@googlegroups.com. >> For more options, visit https://groups.google.com/d/optout. >> > > > > -- > Stephen McDonald > http://jupo.org > -- > You received this message because you are subscribed to the Google Groups > "Mezzanine Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to mezzanine-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. > > > -- > T : 021 081 71732 > > -- > You received this message because you are subscribed to the Google Groups > "Mezzanine Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to mezzanine-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. > > > -- > You received this message because you are subscribed to the Google Groups > "Mezzanine Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to mezzanine-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. > > > -- > T : 021 081 71732 > > -- > You received this message because you are subscribed to the Google Groups > "Mezzanine Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to mezzanine-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. > -- Stephen McDonald http://jupo.org -- You received this message because you are subscribed to the Google Groups "Mezzanine Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to mezzanine-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
