We should also: - Move User guide from Enterprise wiki. Also deprecate the wiki. - It's confusing that the documentation is spread in main wiki, Enterprise and Platform wikis. Maybe we can merge Platform with main wiki? - Not sure why Release Notes and Roadmap are on main wiki and not on Devs.
Thanks, Caty On Fri, Aug 18, 2017 at 7:06 PM, Ecaterina Moraru (Valica) < vali...@gmail.com> wrote: > Hi, > > And the last batch from the Documentation 'saga': > > Proposal for Getting Started: > http://design.xwiki.org/xwiki/bin/download/Proposal/Flavors/ > TechnicalDocumentationFlavor/ExampleXWiki/WebHome/GettingStarted.png > > Current Getting Started: > http://enterprise.xwiki.org/xwiki/bin/view/GettingStarted/ > > --------- > > Proposal for Documentation: > http://design.xwiki.org/xwiki/bin/download/Proposal/Flavors/ > TechnicalDocumentationFlavor/ExampleXWiki/WebHome/Documentation.png > > Current Documentation: > http://www.xwiki.org/xwiki/bin/view/Main/Documentation > > Thanks, > Caty > > P.S: Icons for Guillaume and Eduard :) > > > > > On Fri, Aug 18, 2017 at 5:01 PM, Vincent Massol <vinc...@massol.net> > wrote: > >> >> > On 18 Aug 2017, at 15:48, Ecaterina Moraru (Valica) <vali...@gmail.com> >> wrote: >> > >> > The displayed videos are from Dec 2015, done on XWiki 7.4 (by Silvia) >> and >> > Mar 2016, on XWiki 7.4.1 (by Andrea Russo). >> >> The fact that lots of them use the GWT WYSIWYG editor make them obsolete >> already. >> >> Thanks >> -Vincent >> >> > >> > Thanks, >> > Caty >> > >> > On Fri, Aug 18, 2017 at 4:31 PM, Vincent Massol <vinc...@massol.net> >> wrote: >> > >> >> Hi, >> >> >> >>> On 18 Aug 2017, at 15:28, Ecaterina Moraru (Valica) < >> vali...@gmail.com> >> >> wrote: >> >>> >> >>> Hi, >> >>> >> >>> Proposal for UserGuide: >> >>> http://design.xwiki.org/xwiki/bin/download/Proposal/Flavors/ >> >> TechnicalDocumentationFlavor/ExampleXWiki/WebHome/UserGuide.png >> >> >> >> It’s nice and I like it but it has a cost: we need to redo all videos >> >> since they’re old. >> >> >> >> Thanks >> >> -Vincent >> >> >> >>> >> >>> Current: >> >>> http://enterprise.xwiki.org/xwiki/bin/view/UserGuide/ >> >>> >> >>> Thanks, >> >>> Caty >> >>> >> >>> On Thu, Aug 17, 2017 at 8:23 PM, Ecaterina Moraru (Valica) < >> >>> vali...@gmail.com> wrote: >> >>> >> >>>> Hi, >> >>>> >> >>>> Proposal for DevGuide: >> >>>> http://design.xwiki.org/xwiki/bin/download/Proposal/Flavors/ >> >>>> TechnicalDocumentationFlavor/ExampleXWiki/WebHome/DevGuide.png >> >>>> >> >>>> Current: http://platform.xwiki.org/xwiki/bin/view/DevGuide/ >> >>>> >> >>>> If you have better grouping names/entries, let me know. >> >>>> >> >>>> Thanks, >> >>>> Caty >> >>>> >> >>>> On Thu, Aug 17, 2017 at 7:53 PM, Guillaume Delhumeau < >> >>>> guillaume.delhum...@xwiki.com> wrote: >> >>>> >> >>>>> Would be even better with some icons for each box, but nice >> proposal :) >> >>>>> >> >>>>> 2017-08-17 16:29 GMT+02:00 Vincent Massol <vinc...@massol.net>: >> >>>>> >> >>>>>> >> >>>>>>> On 17 Aug 2017, at 16:14, Ecaterina Moraru (Valica) < >> >>>>> vali...@gmail.com> >> >>>>>> wrote: >> >>>>>>> >> >>>>>>> Hi, >> >>>>>>> >> >>>>>>> Proposal for AdminGuide: >> >>>>>>> http://design.xwiki.org/xwiki/bin/download/Proposal/Flavors/ >> >>>>>> TechnicalDocumentationFlavor/ExampleXWiki/WebHome/AdminGuide.png >> >>>>>> >> >>>>>> So 3 sections: >> >>>>>> * Highlighted topics >> >>>>>> * Main topics >> >>>>>> * Other topics >> >>>>>> >> >>>>>> Sounds good to me. >> >>>>>> >> >>>>>> Thanks >> >>>>>> -Vincent >> >>>>>> >> >>>>>>> >> >>>>>>> Current: http://platform.xwiki.org/xwiki/bin/view/AdminGuide/ >> >>>>>>> >> >>>>>>> Thanks, >> >>>>>>> Caty >> >>>>>>> >> >>>>>>> On Sat, Aug 12, 2017 at 3:12 PM, Vincent Massol < >> vinc...@massol.net> >> >>>>>> wrote: >> >>>>>>> >> >>>>>>>> Hi Caty, >> >>>>>>>> >> >>>>>>>>> On 11 Aug 2017, at 13:51, Ecaterina Moraru (Valica) < >> >>>>> vali...@gmail.com >> >>>>>>> >> >>>>>>>> wrote: >> >>>>>>>>> >> >>>>>>>>> Hi devs, >> >>>>>>>>> >> >>>>>>>>> While thinking about what features a Technical Documentation >> Flavor >> >>>>> [1] >> >>>>>>>>> should have, I came up with some ideas that we could integrate >> >>>>> inside >> >>>>>>>>> xwiki.org in order to make it a better documentation website: >> >>>>>>>>> - navigation tree in the left panel, see >> >>>>>>>>> -- >> >>>>>>>>> http://design.xwiki.org/xwiki/bin/download/Proposal/Flavors/ >> >>>>>>>> TechnicalDocumentationFlavor/ExampleXWiki/WebHome/xwiki_doc_ >> >>>>> partial.png >> >>>>>>>> >> >>>>>>>> As already discussed with you, I really like this screenshot. I >> find >> >>>>> the >> >>>>>>>> UI to be very clean and simple and the navigation on the left is >> >>>>> perfect >> >>>>>>>> for a documentation web site. >> >>>>>>>> >> >>>>>>>>> compared to >> >>>>>>>>> -- http://platform.xwiki.org/xwiki/bin/view/AdminGuide/ >> >> Installation >> >>>>>>>>> - simpler skin (at least remove the comments area - lots of >> >>>>> deprecated >> >>>>>>>>> questions/answers and we have now the forum for that) >> >>>>>>>>> - simpler menu (less entries + merge with the navbar if >> technical >> >>>>>>>> possible >> >>>>>>>>> now, otherwise wait for newer version) >> >>>>>>>>> - simpler footer area by removing the number of links displayed >> (we >> >>>>>> need >> >>>>>>>> to >> >>>>>>>>> look at mouseflow) >> >>>>>>>>> >> >>>>>>>>> Would be great also to upgrade XWiki.org to a newer version. >> >>>>>>>> >> >>>>>>>> Yep. >> >>>>>>>> >> >>>>>>>>> There were all sorts of ideas in the past like: >> >>>>>>>>> - displaying 'Edit' also for unregistered in order to encourage >> >>>>> edits >> >>>>>>>>> - display 'Register'/'Log-in' links in the navbar in order to >> >>>>> encourage >> >>>>>>>>> edits >> >>>>>>>>> these are not part of the current proposal, but keep the ideas >> >>>>> coming >> >>>>>> :) >> >>>>>>>> we >> >>>>>>>>> will try to implement them when we can. >> >>>>>>>>> >> >>>>>>>>> Of course it would be great if we would had time to: >> >>>>>>>>> - update the docs content >> >>>>>>>>> - reorganize pages >> >>>>>>>>> - update the blog styling >> >>>>>>>>> - etc. >> >>>>>>>>> but I guess small changes will come in time. >> >>>>>>>>> >> >>>>>>>>> Let me know what you think, >> >>>>>>>> >> >>>>>>>> I’m really excited by this. I also believe a new L&F is needed >> for >> >>>>>>>> xwiki.org (been several years that it’s not been changed and >> >>>>> novelty is >> >>>>>>>> nice). >> >>>>>>>> >> >>>>>>>> I think you should start implementing this skin on xwiki.org if >> you >> >>>>> can >> >>>>>>>> find some time and on my side I’m willing to help to >> move/reorganize >> >>>>> the >> >>>>>>>> content around (which will be needed as soon as we display the >> >>>>>> navigation >> >>>>>>>> menu on the left). >> >>>>>>>> >> >>>>>>>> Anyone else interested to help out too? >> >>>>>>>> >> >>>>>>>> Thanks >> >>>>>>>> -Vincent >> >>>>>>>> >> >>>>>>>> >> >>>>>>>>> Caty >> >>>>>>>>> >> >>>>>>>>> [1] >> >>>>>>>>> http://design.xwiki.org/xwiki/bin/view/Proposal/Flavors/ >> >>>>>>>> TechnicalDocumentationFlavor/ >> >>>>>>>> >> >>>>>>>> >> >>>>>> >> >>>>>> >> >>>>> >> >>>>> >> >>>>> -- >> >>>>> Guillaume Delhumeau (guillaume.delhum...@xwiki.com) >> >>>>> Research & Development Engineer at XWiki SAS >> >>>>> Committer on the XWiki.org project >> >>>>> >> >>>> >> >>>> >> >> >> >> >> >> >
