Actually, it looks like the staging/docs-grant1 branch has *only* the docs
files, not anything else. If you are seeing directories like geode-core in
your local checkout of the branch, it's probably because you had build
artifacts in those directories and git left the directory around when you
switched branches. I don't see any geode-* directories when I get a clean
checkout or look at the branch on github
<https://github.com/apache/incubator-geode/tree/staging/docs-grant1>.

I think we should just go ahead and create a feature branch off of the the
current geode develop and merge these changes in as a geode-core
subdirectory. We could start the work of cleaning up the build
instructions, etc. right away on that feature branch.

-Dan

On Fri, Sep 30, 2016 at 4:03 PM, Dave Barnes <dbar...@apache.org> wrote:

> Please help me understand the source-control setup for the donated Geode
> docs.
> Per the announcement:
> > The donated source currently sits in a separate branch in the Geode
> repository named staging/docs-grant1
>
> I see when I check out the staging branch that the dozen or so user manual
> source directories are located at the topmost level of the repo,
> interspersed with source code directories. Another four individual files
> are placed at the top level, also, including a README.md that overwrites
> the README.md for the Geode code that I see when I'm working on the develop
> branch.
>
> I think it would be easier to find the files and distinguish them from
> source code if they were located in their own subdirectory, maybe
> 'geode-docs' for example. This would be helpful during the comment period,
> as well as later when the docs have been accepted as part of the main repo.
> - To what extent is the directory structure dictated by Apache precedent?
> - Can the locations be changed during the comment period?
> - If not, can the locations be changed after the comment period, before the
> branch is merged into the main repo?
>
> Thanks,
> Dave Barnes
>

Reply via email to