It's just a regular Mezzanine project - there aren't any special instructions.
On Sun, May 24, 2015 at 3:08 PM, Graham <[email protected]> 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 < > [email protected]> 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 <[email protected]> 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 [email protected]. >>>> 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 [email protected]. >> 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 [email protected]. > 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 [email protected]. > 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 [email protected]. > 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 [email protected]. > 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 [email protected]. For more options, visit https://groups.google.com/d/optout.
