I agree with Jerry that we should put doc with the codebase repo so that when we add new futures, we could update docs at the the same time, otherwise we may make the code and docs in an inconsistent state. According my experience in apache community, many apache project use this approach.
Saisai Shao <sai.sai.s...@gmail.com>于2017年7月26日周三 下午1:53写道： > I'm in favor of store the docs in main repo, while put seldom changed > frameworks in website repo. I think you already mentioned the reason here > (as > the Documentation grows and changes from version to version it would be > better to store it in the more regularly updated repo). > > What I saw is that Spark put all the docs with version separated in here ( > https://github.com/apache/spark-website/tree/asf-site/site/docs). So that > user could check docs with right version. I think in Livy we could also > maintain a such folder to put each release version's doc here (either > manually or by script). As for now (because we don't have a release) we > could create an "unreleased" folder to maintain docs in master branch, also > sync the docs periodically if anything changed. > > > On Wed, Jul 26, 2017 at 4:48 AM, Alex Bozarth <ajboz...@us.ibm.com> wrote: > > > > > > > Hey Team > > > > Jerry and I have been discussing (on my recent PR) where we should keep > the > > Livy Documentation files as we move them out of the README. My PR > > originally moved the two Doc files (on the REST and Programmatic APIs) > into > > the livy website repos so we can display them via the website. Jerry > > proposed that we keep them in the main livy repo like how Spark does it. > > Personally given we have just two files I think leaving them in the > website > > repo is simplier for us, but I also understand that as the Documentation > > grows and changes from version to version it would be better to store it > in > > the more regularly updated repo. > > > > What are everyone's opinions on where the Docs should be stored? If we > > decide to store them in the main repo does anyone have pointers on how to > > simply and cleanly sync them to the website for viewing. You can see my > > Documenation and README update PRs here: > > https://github.com/apache/incubator-livy/pull/21 > > https://github.com/apache/incubator-livy-website/pull/5 > > > > > > Alex Bozarth > > Software Engineer > > Spark Technology Center > > > > > > > > > > E-mail: ajboz...@us.ibm.com > > GitHub: github.com/ajbozarth > > 505 > > Howard Street > > San > > Francisco, CA 94105 > > > > United States > > > > > > > > > > > > >
