hawq-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Yozie <dyo...@pivotal.io>
Subject Re: Hawq repositories
Date Thu, 25 May 2017 22:25:28 GMT
Great - my proposal then is to merge the full contents of the
incubator-hawq-docs master branch into a new "hawq-docs" subdirectory of
the incubator-hawq source repo.  This is to avoid any conflicts with the
existing "docs" directory, which contains SGML files used for command-line
tool help.

After that, I can modify the README in incubator-hawq-docs to point to the
correct location and/or make it a read-only repo.

Let me know if there are any concerns about the above, or other suggestions
for managing the docs source alongside the code.



On Thu, May 25, 2017 at 11:28 AM, Shivram Mani <shivram.mani@gmail.com>

> David, that would be great !
> We could address incubator-hawq-site docs later given the nature of its
> document source.
> On Wed, May 24, 2017 at 2:43 PM, David Yozie <dyozie@pivotal.io> wrote:
>> Shivram:  I was just about to propose moving the incubator-hawq-docs
>> source into a subdirectory of incubator-hawq.  That organization seems to
>> be more common with Apache projects and I'm hopeful that having docs source
>> alongside the code will encourage more doc contributions (ie. PRs with both
>> the code changes and doc changes).
>> Most of the docs on incubator-hawq-site are just HTML files generated
>> from the source.  I don't think we'd necessarily want to combine that
>> compiled output alongside source.
>> -David
>> On Wed, May 24, 2017 at 2:07 PM, Shivram Mani <shivram.mani@gmail.com>
>> wrote:
>>> Why can't we integrate the hawq docs
>>> <https://github.com/apache/incubator-hawq-docs> and the hawq incubator
>>> site
>>> docs <https://github.com/apache/incubator-hawq-site/> repositories as
>>> part
>>> of the incubator hawq repository <https://github.com/apache/inc
>>> ubator-hawq>
>>> ? Its a bit cumbersome for new committers who intend to contribute to
>>> docs
>>> to keep track of three different repositories and also request for
>>> permission on each of them.
>>> --
>>> shivram mani
> --
> shivram mani

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message