You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@hawq.apache.org by Shivram Mani <sh...@gmail.com> on 2017/05/24 21:07:51 UTC
Hawq repositories
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/incubator-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
Re: Hawq repositories
Posted by David Yozie <dy...@pivotal.io>.
I just wanted to offer one last chance for feedback on this. Unless I hear
to the contrary, I'll be mergin in the full contents of the
incubator-hawq-docs master branch into a new "hawq-docs" subdirectory of
the incubator-hawq source repo sometime tomorrow morning. Will be using
--allow-unrelated-histories to bring in the commit history of the older
-docs repo. If you have any concerns or suggestions please let me know.
Thanks again,
-David
On Thu, May 25, 2017 at 7:41 PM, Lei Chang <ch...@gmail.com> wrote:
>
> David, looks a great proposal, this will ease the dev & doc
> synchronization a lot.
>
> Cheers
> Lei
>
>
> On Fri, May 26, 2017 at 6:25 AM, David Yozie <dy...@pivotal.io> wrote:
>
>> 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.
>>
>> Thanks,
>>
>> -David
>>
>> On Thu, May 25, 2017 at 11:28 AM, Shivram Mani <sh...@gmail.com>
>> wrote:
>>
>> > 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 <dy...@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 <sh...@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
>> >
>>
>
>
Re: Hawq repositories
Posted by David Yozie <dy...@pivotal.io>.
I just wanted to offer one last chance for feedback on this. Unless I hear
to the contrary, I'll be mergin in the full contents of the
incubator-hawq-docs master branch into a new "hawq-docs" subdirectory of
the incubator-hawq source repo sometime tomorrow morning. Will be using
--allow-unrelated-histories to bring in the commit history of the older
-docs repo. If you have any concerns or suggestions please let me know.
Thanks again,
-David
On Thu, May 25, 2017 at 7:41 PM, Lei Chang <ch...@gmail.com> wrote:
>
> David, looks a great proposal, this will ease the dev & doc
> synchronization a lot.
>
> Cheers
> Lei
>
>
> On Fri, May 26, 2017 at 6:25 AM, David Yozie <dy...@pivotal.io> wrote:
>
>> 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.
>>
>> Thanks,
>>
>> -David
>>
>> On Thu, May 25, 2017 at 11:28 AM, Shivram Mani <sh...@gmail.com>
>> wrote:
>>
>> > 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 <dy...@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 <sh...@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
>> >
>>
>
>
Re: Hawq repositories
Posted by Lei Chang <ch...@gmail.com>.
David, looks a great proposal, this will ease the dev & doc synchronization
a lot.
Cheers
Lei
On Fri, May 26, 2017 at 6:25 AM, David Yozie <dy...@pivotal.io> wrote:
> 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.
>
> Thanks,
>
> -David
>
> On Thu, May 25, 2017 at 11:28 AM, Shivram Mani <sh...@gmail.com>
> wrote:
>
> > 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 <dy...@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 <sh...@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
> >
>
Re: Hawq repositories
Posted by Lei Chang <ch...@gmail.com>.
David, looks a great proposal, this will ease the dev & doc synchronization
a lot.
Cheers
Lei
On Fri, May 26, 2017 at 6:25 AM, David Yozie <dy...@pivotal.io> wrote:
> 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.
>
> Thanks,
>
> -David
>
> On Thu, May 25, 2017 at 11:28 AM, Shivram Mani <sh...@gmail.com>
> wrote:
>
> > 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 <dy...@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 <sh...@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
> >
>
Re: Hawq repositories
Posted by David Yozie <dy...@pivotal.io>.
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.
Thanks,
-David
On Thu, May 25, 2017 at 11:28 AM, Shivram Mani <sh...@gmail.com>
wrote:
> 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 <dy...@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 <sh...@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
>
Re: Hawq repositories
Posted by David Yozie <dy...@pivotal.io>.
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.
Thanks,
-David
On Thu, May 25, 2017 at 11:28 AM, Shivram Mani <sh...@gmail.com>
wrote:
> 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 <dy...@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 <sh...@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
>
Re: Hawq repositories
Posted by Shivram Mani <sh...@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 <dy...@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 <sh...@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
Re: Hawq repositories
Posted by Shivram Mani <sh...@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 <dy...@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 <sh...@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
Re: Hawq repositories
Posted by David Yozie <dy...@pivotal.io>.
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 <sh...@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/incubator-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
>
Re: Hawq repositories
Posted by David Yozie <dy...@pivotal.io>.
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 <sh...@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/incubator-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
>