Yes, currently new way have to commit both. that means you have to push source(markdown) into git and then commit html files into svn. If we don’t care about url, we can use a readthedocs hosting such as libcloud[1]. Of course, I prefer using readthedocs hosting. I have to change if we take this. What do you think?
https://libcloud.readthedocs.org/en/latest/ <https://libcloud.readthedocs.org/en/latest/> > On Nov 4, 2014, at 8:30 AM, Rod Simpson <[email protected]> wrote: > > 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 <https://twitter.com/rockerston> > rodsimpson.com <http://rodsimpson.com/> > On November 3, 2014 at 4:21:43 PM, Sungju Jin ([email protected] > <mailto:[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> >> <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] >> > <mailto:[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 >> > <https://twitter.com/rockerston>> >> > rodsimpson.com <http://rodsimpson.com/> <http://rodsimpson.com/ >> > <http://rodsimpson.com/>> >> > On October 21, 2014 at 7:04:50 AM, Sungju Jin ([email protected] >> > <mailto:[email protected]> <mailto:[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> >> >> <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>> >> >> <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] >> >> > <mailto:[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 >> >> > <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] <mailto:[email protected]>> wrote: >> >> > >> >> >> Hi Sungju, >> >> >> >> >> >> On Mon, Oct 20, 2014 at 7:01 PM, < >> >> >> [email protected] >> >> >> <mailto:[email protected]> >> >> >> <mailto:[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> >> >> >>> <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> >> >> >> <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 >> >> >>
