You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@knox.apache.org by Kevin Minder <ke...@hortonworks.com> on 2013/10/30 19:40:03 UTC
Starting design docs in wiki
Hi Everyone,
I'm starting to sketch out some designs for various jira as child pages
of this wiki.
https://cwiki.apache.org/confluence/display/KNOX/Designs
I'd love feedback on both the content as well as the use of the wiki for
this.
Kevin.
--
CONFIDENTIALITY NOTICE
NOTICE: This message is intended for the use of the individual or entity to
which it is addressed and may contain information that is confidential,
privileged and exempt from disclosure under applicable law. If the reader
of this message is not the intended recipient, you are hereby notified that
any printing, copying, dissemination, distribution, disclosure or
forwarding of this communication is strictly prohibited. If you have
received this communication in error, please contact the sender immediately
and delete it from your system. Thank You.
Re: Starting design docs in wiki
Posted by Dilli Arumugam <da...@hortonworks.com>.
Confirming it worked for me as well - I did some minor edits in the morning
to the wiki page.
But, I was not sure whether Larry and I got privilege due to being
committers.
Thanks
Dilli
On Wed, Oct 30, 2013 at 12:28 PM, larry mccay <la...@gmail.com> wrote:
> I already logged in and added a comment to the provider one.
>
>
> On Wed, Oct 30, 2013 at 3:27 PM, Kevin Minder
> <ke...@hortonworks.com>wrote:
>
> > My intent was for this to be editable and commentable by anyone that can
> > login.
> > Can someone confirm that this is the case by default?
> > If not we may need to ask for some help from infra.
> >
> >
> > On 10/30/13 2:58 PM, Dilli Arumugam wrote:
> >
> >> The styles and formatting in wiki makes it much more readable and
> >> comprehensible.
> >>
> >> As long as the JIRA has a link to it and other dev community members can
> >> comment on the design either in the wiki or in the related JIRA, would
> >> vote for wiki for design doc.
> >>
> >>
> >>
> >> On Wed, Oct 30, 2013 at 11:50 AM, larry mccay <la...@gmail.com>
> >> wrote:
> >>
> >> I think that the wiki is a good scratch pad but as far as open
> discussion
> >>> of the designs - I think JIRA is better.
> >>> For instance, when I look at the simple way to add providers - my one
> >>> comment is that it really should be custom instead of default.
> >>> If this were a gdoc then I could easily add a comment to the doc.
> >>> If it were a JIRA, I can also comment.
> >>> I suppose that I could edit the Wiki and leave an <ljm>comment</ljm>
> >>> comment.
> >>>
> >>> Other than that, I think wiki is well suited for hashing this stuff
> out.
> >>> Feels sort of like the Blueprints used in OpenStack land - though I'm
> not
> >>> sure that they are wiki per se.
> >>>
> >>>
> >>> On Wed, Oct 30, 2013 at 2:40 PM, Kevin Minder
> >>> <ke...@hortonworks.com>**wrote:
> >>>
> >>> Hi Everyone,
> >>>> I'm starting to sketch out some designs for various jira as child
> pages
> >>>>
> >>> of
> >>>
> >>>> this wiki.
> >>>> https://cwiki.apache.org/****confluence/display/KNOX/****Designs<
> https://cwiki.apache.org/**confluence/display/KNOX/**Designs>
> >>>> <
> >>>>
> >>> https://cwiki.apache.org/**confluence/display/KNOX/**Designs<
> https://cwiki.apache.org/confluence/display/KNOX/Designs>
> >>> >
> >>>
> >>>> I'd love feedback on both the content as well as the use of the wiki
> for
> >>>> this.
> >>>> Kevin.
> >>>>
> >>>> --
> >>>> CONFIDENTIALITY NOTICE
> >>>> NOTICE: This message is intended for the use of the individual or
> entity
> >>>> to which it is addressed and may contain information that is
> >>>>
> >>> confidential,
> >>>
> >>>> privileged and exempt from disclosure under applicable law. If the
> >>>> reader
> >>>> of this message is not the intended recipient, you are hereby notified
> >>>>
> >>> that
> >>>
> >>>> any printing, copying, dissemination, distribution, disclosure or
> >>>> forwarding of this communication is strictly prohibited. If you have
> >>>> received this communication in error, please contact the sender
> >>>>
> >>> immediately
> >>>
> >>>> and delete it from your system. Thank You.
> >>>>
> >>>>
> >
> > --
> > CONFIDENTIALITY NOTICE
> > NOTICE: This message is intended for the use of the individual or entity
> > to which it is addressed and may contain information that is
> confidential,
> > privileged and exempt from disclosure under applicable law. If the reader
> > of this message is not the intended recipient, you are hereby notified
> that
> > any printing, copying, dissemination, distribution, disclosure or
> > forwarding of this communication is strictly prohibited. If you have
> > received this communication in error, please contact the sender
> immediately
> > and delete it from your system. Thank You.
> >
>
--
CONFIDENTIALITY NOTICE
NOTICE: This message is intended for the use of the individual or entity to
which it is addressed and may contain information that is confidential,
privileged and exempt from disclosure under applicable law. If the reader
of this message is not the intended recipient, you are hereby notified that
any printing, copying, dissemination, distribution, disclosure or
forwarding of this communication is strictly prohibited. If you have
received this communication in error, please contact the sender immediately
and delete it from your system. Thank You.
Re: Starting design docs in wiki
Posted by larry mccay <la...@gmail.com>.
I already logged in and added a comment to the provider one.
On Wed, Oct 30, 2013 at 3:27 PM, Kevin Minder
<ke...@hortonworks.com>wrote:
> My intent was for this to be editable and commentable by anyone that can
> login.
> Can someone confirm that this is the case by default?
> If not we may need to ask for some help from infra.
>
>
> On 10/30/13 2:58 PM, Dilli Arumugam wrote:
>
>> The styles and formatting in wiki makes it much more readable and
>> comprehensible.
>>
>> As long as the JIRA has a link to it and other dev community members can
>> comment on the design either in the wiki or in the related JIRA, would
>> vote for wiki for design doc.
>>
>>
>>
>> On Wed, Oct 30, 2013 at 11:50 AM, larry mccay <la...@gmail.com>
>> wrote:
>>
>> I think that the wiki is a good scratch pad but as far as open discussion
>>> of the designs - I think JIRA is better.
>>> For instance, when I look at the simple way to add providers - my one
>>> comment is that it really should be custom instead of default.
>>> If this were a gdoc then I could easily add a comment to the doc.
>>> If it were a JIRA, I can also comment.
>>> I suppose that I could edit the Wiki and leave an <ljm>comment</ljm>
>>> comment.
>>>
>>> Other than that, I think wiki is well suited for hashing this stuff out.
>>> Feels sort of like the Blueprints used in OpenStack land - though I'm not
>>> sure that they are wiki per se.
>>>
>>>
>>> On Wed, Oct 30, 2013 at 2:40 PM, Kevin Minder
>>> <ke...@hortonworks.com>**wrote:
>>>
>>> Hi Everyone,
>>>> I'm starting to sketch out some designs for various jira as child pages
>>>>
>>> of
>>>
>>>> this wiki.
>>>> https://cwiki.apache.org/****confluence/display/KNOX/****Designs<https://cwiki.apache.org/**confluence/display/KNOX/**Designs>
>>>> <
>>>>
>>> https://cwiki.apache.org/**confluence/display/KNOX/**Designs<https://cwiki.apache.org/confluence/display/KNOX/Designs>
>>> >
>>>
>>>> I'd love feedback on both the content as well as the use of the wiki for
>>>> this.
>>>> Kevin.
>>>>
>>>> --
>>>> CONFIDENTIALITY NOTICE
>>>> NOTICE: This message is intended for the use of the individual or entity
>>>> to which it is addressed and may contain information that is
>>>>
>>> confidential,
>>>
>>>> privileged and exempt from disclosure under applicable law. If the
>>>> reader
>>>> of this message is not the intended recipient, you are hereby notified
>>>>
>>> that
>>>
>>>> any printing, copying, dissemination, distribution, disclosure or
>>>> forwarding of this communication is strictly prohibited. If you have
>>>> received this communication in error, please contact the sender
>>>>
>>> immediately
>>>
>>>> and delete it from your system. Thank You.
>>>>
>>>>
>
> --
> CONFIDENTIALITY NOTICE
> NOTICE: This message is intended for the use of the individual or entity
> to which it is addressed and may contain information that is confidential,
> privileged and exempt from disclosure under applicable law. If the reader
> of this message is not the intended recipient, you are hereby notified that
> any printing, copying, dissemination, distribution, disclosure or
> forwarding of this communication is strictly prohibited. If you have
> received this communication in error, please contact the sender immediately
> and delete it from your system. Thank You.
>
Re: Starting design docs in wiki
Posted by Kevin Minder <ke...@hortonworks.com>.
My intent was for this to be editable and commentable by anyone that can
login.
Can someone confirm that this is the case by default?
If not we may need to ask for some help from infra.
On 10/30/13 2:58 PM, Dilli Arumugam wrote:
> The styles and formatting in wiki makes it much more readable and
> comprehensible.
>
> As long as the JIRA has a link to it and other dev community members can
> comment on the design either in the wiki or in the related JIRA, would
> vote for wiki for design doc.
>
>
>
> On Wed, Oct 30, 2013 at 11:50 AM, larry mccay <la...@gmail.com> wrote:
>
>> I think that the wiki is a good scratch pad but as far as open discussion
>> of the designs - I think JIRA is better.
>> For instance, when I look at the simple way to add providers - my one
>> comment is that it really should be custom instead of default.
>> If this were a gdoc then I could easily add a comment to the doc.
>> If it were a JIRA, I can also comment.
>> I suppose that I could edit the Wiki and leave an <ljm>comment</ljm>
>> comment.
>>
>> Other than that, I think wiki is well suited for hashing this stuff out.
>> Feels sort of like the Blueprints used in OpenStack land - though I'm not
>> sure that they are wiki per se.
>>
>>
>> On Wed, Oct 30, 2013 at 2:40 PM, Kevin Minder
>> <ke...@hortonworks.com>wrote:
>>
>>> Hi Everyone,
>>> I'm starting to sketch out some designs for various jira as child pages
>> of
>>> this wiki.
>>> https://cwiki.apache.org/**confluence/display/KNOX/**Designs<
>> https://cwiki.apache.org/confluence/display/KNOX/Designs>
>>> I'd love feedback on both the content as well as the use of the wiki for
>>> this.
>>> Kevin.
>>>
>>> --
>>> CONFIDENTIALITY NOTICE
>>> NOTICE: This message is intended for the use of the individual or entity
>>> to which it is addressed and may contain information that is
>> confidential,
>>> privileged and exempt from disclosure under applicable law. If the reader
>>> of this message is not the intended recipient, you are hereby notified
>> that
>>> any printing, copying, dissemination, distribution, disclosure or
>>> forwarding of this communication is strictly prohibited. If you have
>>> received this communication in error, please contact the sender
>> immediately
>>> and delete it from your system. Thank You.
>>>
--
CONFIDENTIALITY NOTICE
NOTICE: This message is intended for the use of the individual or entity to
which it is addressed and may contain information that is confidential,
privileged and exempt from disclosure under applicable law. If the reader
of this message is not the intended recipient, you are hereby notified that
any printing, copying, dissemination, distribution, disclosure or
forwarding of this communication is strictly prohibited. If you have
received this communication in error, please contact the sender immediately
and delete it from your system. Thank You.
Re: Starting design docs in wiki
Posted by Dilli Arumugam <da...@hortonworks.com>.
The styles and formatting in wiki makes it much more readable and
comprehensible.
As long as the JIRA has a link to it and other dev community members can
comment on the design either in the wiki or in the related JIRA, would
vote for wiki for design doc.
On Wed, Oct 30, 2013 at 11:50 AM, larry mccay <la...@gmail.com> wrote:
> I think that the wiki is a good scratch pad but as far as open discussion
> of the designs - I think JIRA is better.
> For instance, when I look at the simple way to add providers - my one
> comment is that it really should be custom instead of default.
> If this were a gdoc then I could easily add a comment to the doc.
> If it were a JIRA, I can also comment.
> I suppose that I could edit the Wiki and leave an <ljm>comment</ljm>
> comment.
>
> Other than that, I think wiki is well suited for hashing this stuff out.
> Feels sort of like the Blueprints used in OpenStack land - though I'm not
> sure that they are wiki per se.
>
>
> On Wed, Oct 30, 2013 at 2:40 PM, Kevin Minder
> <ke...@hortonworks.com>wrote:
>
> > Hi Everyone,
> > I'm starting to sketch out some designs for various jira as child pages
> of
> > this wiki.
> > https://cwiki.apache.org/**confluence/display/KNOX/**Designs<
> https://cwiki.apache.org/confluence/display/KNOX/Designs>
> > I'd love feedback on both the content as well as the use of the wiki for
> > this.
> > Kevin.
> >
> > --
> > CONFIDENTIALITY NOTICE
> > NOTICE: This message is intended for the use of the individual or entity
> > to which it is addressed and may contain information that is
> confidential,
> > privileged and exempt from disclosure under applicable law. If the reader
> > of this message is not the intended recipient, you are hereby notified
> that
> > any printing, copying, dissemination, distribution, disclosure or
> > forwarding of this communication is strictly prohibited. If you have
> > received this communication in error, please contact the sender
> immediately
> > and delete it from your system. Thank You.
> >
>
--
CONFIDENTIALITY NOTICE
NOTICE: This message is intended for the use of the individual or entity to
which it is addressed and may contain information that is confidential,
privileged and exempt from disclosure under applicable law. If the reader
of this message is not the intended recipient, you are hereby notified that
any printing, copying, dissemination, distribution, disclosure or
forwarding of this communication is strictly prohibited. If you have
received this communication in error, please contact the sender immediately
and delete it from your system. Thank You.
Re: Starting design docs in wiki
Posted by Kevin Minder <ke...@hortonworks.com>.
The wiki has a comment feature. Ideally what I would have liked is full
cwiki support for the Jira description. Unfortunately while it does
support some markup it is very limited.
BTW I agree about the name "default". I had considered "custom" but I'm
leaning toward "generic" now.
On 10/30/13 2:50 PM, larry mccay wrote:
> I think that the wiki is a good scratch pad but as far as open discussion
> of the designs - I think JIRA is better.
> For instance, when I look at the simple way to add providers - my one
> comment is that it really should be custom instead of default.
> If this were a gdoc then I could easily add a comment to the doc.
> If it were a JIRA, I can also comment.
> I suppose that I could edit the Wiki and leave an <ljm>comment</ljm>
> comment.
>
> Other than that, I think wiki is well suited for hashing this stuff out.
> Feels sort of like the Blueprints used in OpenStack land - though I'm not
> sure that they are wiki per se.
>
>
> On Wed, Oct 30, 2013 at 2:40 PM, Kevin Minder
> <ke...@hortonworks.com>wrote:
>
>> Hi Everyone,
>> I'm starting to sketch out some designs for various jira as child pages of
>> this wiki.
>> https://cwiki.apache.org/**confluence/display/KNOX/**Designs<https://cwiki.apache.org/confluence/display/KNOX/Designs>
>> I'd love feedback on both the content as well as the use of the wiki for
>> this.
>> Kevin.
>>
>> --
>> CONFIDENTIALITY NOTICE
>> NOTICE: This message is intended for the use of the individual or entity
>> to which it is addressed and may contain information that is confidential,
>> privileged and exempt from disclosure under applicable law. If the reader
>> of this message is not the intended recipient, you are hereby notified that
>> any printing, copying, dissemination, distribution, disclosure or
>> forwarding of this communication is strictly prohibited. If you have
>> received this communication in error, please contact the sender immediately
>> and delete it from your system. Thank You.
>>
--
CONFIDENTIALITY NOTICE
NOTICE: This message is intended for the use of the individual or entity to
which it is addressed and may contain information that is confidential,
privileged and exempt from disclosure under applicable law. If the reader
of this message is not the intended recipient, you are hereby notified that
any printing, copying, dissemination, distribution, disclosure or
forwarding of this communication is strictly prohibited. If you have
received this communication in error, please contact the sender immediately
and delete it from your system. Thank You.
Re: Starting design docs in wiki
Posted by larry mccay <la...@gmail.com>.
Nevermind, there is a comment in the wiki as well.
Duh. :/
On Wed, Oct 30, 2013 at 2:50 PM, larry mccay <la...@gmail.com> wrote:
> I think that the wiki is a good scratch pad but as far as open discussion
> of the designs - I think JIRA is better.
> For instance, when I look at the simple way to add providers - my one
> comment is that it really should be custom instead of default.
> If this were a gdoc then I could easily add a comment to the doc.
> If it were a JIRA, I can also comment.
> I suppose that I could edit the Wiki and leave an <ljm>comment</ljm>
> comment.
>
> Other than that, I think wiki is well suited for hashing this stuff out.
> Feels sort of like the Blueprints used in OpenStack land - though I'm not
> sure that they are wiki per se.
>
>
> On Wed, Oct 30, 2013 at 2:40 PM, Kevin Minder <
> kevin.minder@hortonworks.com> wrote:
>
>> Hi Everyone,
>> I'm starting to sketch out some designs for various jira as child pages
>> of this wiki.
>> https://cwiki.apache.org/**confluence/display/KNOX/**Designs<https://cwiki.apache.org/confluence/display/KNOX/Designs>
>> I'd love feedback on both the content as well as the use of the wiki for
>> this.
>> Kevin.
>>
>> --
>> CONFIDENTIALITY NOTICE
>> NOTICE: This message is intended for the use of the individual or entity
>> to which it is addressed and may contain information that is confidential,
>> privileged and exempt from disclosure under applicable law. If the reader
>> of this message is not the intended recipient, you are hereby notified that
>> any printing, copying, dissemination, distribution, disclosure or
>> forwarding of this communication is strictly prohibited. If you have
>> received this communication in error, please contact the sender immediately
>> and delete it from your system. Thank You.
>>
>
>
Re: Starting design docs in wiki
Posted by larry mccay <la...@gmail.com>.
I think that the wiki is a good scratch pad but as far as open discussion
of the designs - I think JIRA is better.
For instance, when I look at the simple way to add providers - my one
comment is that it really should be custom instead of default.
If this were a gdoc then I could easily add a comment to the doc.
If it were a JIRA, I can also comment.
I suppose that I could edit the Wiki and leave an <ljm>comment</ljm>
comment.
Other than that, I think wiki is well suited for hashing this stuff out.
Feels sort of like the Blueprints used in OpenStack land - though I'm not
sure that they are wiki per se.
On Wed, Oct 30, 2013 at 2:40 PM, Kevin Minder
<ke...@hortonworks.com>wrote:
> Hi Everyone,
> I'm starting to sketch out some designs for various jira as child pages of
> this wiki.
> https://cwiki.apache.org/**confluence/display/KNOX/**Designs<https://cwiki.apache.org/confluence/display/KNOX/Designs>
> I'd love feedback on both the content as well as the use of the wiki for
> this.
> Kevin.
>
> --
> CONFIDENTIALITY NOTICE
> NOTICE: This message is intended for the use of the individual or entity
> to which it is addressed and may contain information that is confidential,
> privileged and exempt from disclosure under applicable law. If the reader
> of this message is not the intended recipient, you are hereby notified that
> any printing, copying, dissemination, distribution, disclosure or
> forwarding of this communication is strictly prohibited. If you have
> received this communication in error, please contact the sender immediately
> and delete it from your system. Thank You.
>