Thank you for your comments. Also batchee link helps me. I’m not sure community wants to integrate docs into our git(https://git-wip-us.apache.org/repos/asf/incubator-usergrid.git) As you know, it’s simple technically. However, I think it means contribution flow changes. So, I’d like to get more other thinking(agreed or disagreed)
If I change this, 1. Creating a docs module (maven) 2. Putting md files into git 3. Generating docs that use sphinx-maven plugin[1] when we push our site [1] https://github.com/tomdz/sphinx-maven <https://github.com/tomdz/sphinx-maven> > 2014. 10. 21., 오후 7:57, John D. Ament <[email protected]> 작성: > > Hi, > > In a number of other projects out there in apache land, we're doing similar > types of integration. WDYT about storing your MD files in your git repo as > a first step, and using a site style integration to generate (via maven) > the content and push to your website? > > Then once you're satisfied you can publish. > > You can see an example of how BatchEE does it at [1] > > - John > > [1]: https://github.com/apache/incubator-batchee/blob/master/pom.xml#L427 > > > > On Mon, Oct 20, 2014 at 10:40 PM, Lewis John Mcgibbney < > [email protected]> wrote: > >> Hi Sungju, >> >> On Mon, Oct 20, 2014 at 7:01 PM, < >> [email protected]> wrote: >> >>> Can we change document system? >>> Currently the docs system is not easy to contribute and manage the >>> version, search in the docs. >>> >> >> Point taken, this has been flagged up elsewhere recently as well. >> >> >>> I have been working changing docs system to sphinx (readthedocs theme) >>> from our ruby generator. If we want to change, the doc repository(svn) >> has to >>> integrate our git(https://github.com/apache/incubator-usergrid) as well. >>> >> >> Not sure if this is where we want it to be pointing. >> I feel that this should probably be >> https://git-wip-us.apache.org/repos/asf/incubator-usergrid.git >> >> >>> >>> Benefits >>> - Easily Contribute than before (directly git) >>> - Improve Search >>> - Support pdf, other formats >>> >> >> Are all of these still relevant if we specify the Apache hosted Git code? >> Can you review again and comment? >> >> >>> >>> Look at the attached prototype screenshot. What do you think? Any >> feedback >>> is welcome. >>> >>> >>> Attachment of any kind are stripped from mailing lists. >> Would be great if you could make the screenshot available some other way. >> Thanks >> Lewis >>
