So I guess I am confused as to the flow for getting this into our SVN (where the docs live). Are we going to commit it to git, then commit to SVN?
-- Rod Simpson @rockerston rodsimpson.com On November 3, 2014 at 4:21:43 PM, Sungju Jin ([email protected]) wrote: Rod, Thank you for your comment! I already send a PR. You can review and merge a PR. https://github.com/apache/incubator-usergrid/pull/86 <https://github.com/apache/incubator-usergrid/pull/86> Regards, Sungju > On Nov 4, 2014, at 7:51 AM, Rod Simpson <[email protected]> wrote: > > Sungju, > > This looks awesome and would be a great addition. I don’t think we need to > take a vote on this (someone correct me if I am wrong). But I think you can > go ahead and push your changes. > > Rod > > -- > Rod Simpson > @rockerston <https://twitter.com/rockerston> > rodsimpson.com <http://rodsimpson.com/> > On October 21, 2014 at 7:04:50 AM, Sungju Jin ([email protected] > <mailto:[email protected]>) wrote: > >> 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 >> <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> >> <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] >> >> <mailto:[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 >> >>> <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 >> >> <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 >> >>
