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
>

Reply via email to