You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@royale.apache.org by Harbs <ha...@gmail.com> on 2017/10/02 18:14:40 UTC
Github wikis
INFRA just informed us that Github Wikis are now an option and they want to know which repos we want wikis for.[1]
royale-asjs and royale-compiler seem like no-brainers.
What about royale-typedefs, royale-tourjs and royale-website? Does anyone see a reason for a wiki in those?
At what point do folks think we should set up an “examples” repo? A wiki would probably be appropriate on something like that.
Thanks,
Harbs
[1]https://issues.apache.org/jira/browse/INFRA-15138?focusedCommentId=16188401&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-16188401
Re: Github wikis
Posted by Alex Harui <ah...@adobe.com.INVALID>.
I think I learned that Github Pages is not per-repo, it is one per Apache
Project.
It is a bit easier to have one repo per release product. Combining repos
for a release is a bit of extra work. There should be examples in the
IDE-friendly artifact. IMO, TourJS would have its own release schedule.
My 2 cents,
-Alex
On 10/2/17, 11:32 AM, "Harbs" <ha...@gmail.com> wrote:
>I’d like to setup an example repo so it’ll build a website (i.e. Github
>Pages) where the samples could be run. It seems similar to tourjs in a
>way, but different. “Examples” to me is more like a tutorial on how to
>use Royale while tourjs is more of a reference of the components. They
>seem separate and complimentary.
>
>Harbs
>
>
>> On Oct 2, 2017, at 9:25 PM, Peter Ent <pe...@adobe.com.INVALID> wrote:
>>
>> I have been thinking that examples should be moved from royale-asjs and
>> put into its own royals-examples repo and then a wiki for that would
>>work
>> well.
>>
>> Maybe the tourjs should be a subdirectory in examples.
>>
>> ‹peter
>>
>> On 10/2/17, 2:14 PM, "Harbs" <ha...@gmail.com> wrote:
>>
>>> INFRA just informed us that Github Wikis are now an option and they
>>>want
>>> to know which repos we want wikis for.[1]
>>>
>>> royale-asjs and royale-compiler seem like no-brainers.
>>>
>>> What about royale-typedefs, royale-tourjs and royale-website? Does
>>>anyone
>>> see a reason for a wiki in those?
>>>
>>> At what point do folks think we should set up an ³examples² repo? A
>>>wiki
>>> would probably be appropriate on something like that.
>>>
>>> Thanks,
>>> Harbs
>>>
>>>
>>>[1]https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fissu
>>>es
>>>
>>>.apache.org%2Fjira%2Fbrowse%2FINFRA-15138%3FfocusedCommentId%3D16188401%
>>>26
>>>
>>>page%3Dcom.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpane
>>>l%
>>>
>>>23comment-16188401&data=02%7C01%7C%7Cf13e83a4f7594535bec608d509c176d8%7C
>>>fa
>>>
>>>7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425648884686688&sdata=%2FSBh
>>>%2
>>> BpyjIfrx%2FcwnFZAxqD%2FGdT3lvte6%2FWItPQDTIqs%3D&reserved=0
>>
>
Re: Github wikis
Posted by Alex Harui <ah...@adobe.com.INVALID>.
Examples are downstream of the sdk since they require the sdk.
Some projects do have separate packages for examples to lower the download
size, but I think we should at least bundle some key ones.
My 2 cents,
-Alex
On 10/2/17, 11:59 AM, "Peter Ent" <pe...@adobe.com.INVALID> wrote:
>I was thinking that examples should be upstream from the sdk. They are now
>in that they cannot be built with the sdk created first.
>
>However, the examples aren't actually "products" where you could agree the
>tour is. If we introduce a new component there would be an example created
>for it. If the tour could make use it, we would update the tour - at some
>point.
>
>So I guess I retract my suggestion of making examples its own repo.
>
>—peter
>
>On 10/2/17, 2:46 PM, "Piotr Zarzycki" <pi...@gmail.com> wrote:
>
>>Hi,
>>
>>I don't see to much reason for having royale-website wiki - as long as we
>>decide where actually documentation goes.
>>
>>Another repo for examples, does examples which we already have ?
>>
>>I believe that is good that we are shipping examples along with our
>>framework repo - How we will ship that ?
>>
>>Piotr
>>
>>
>>
>>2017-10-02 20:32 GMT+02:00 Harbs <ha...@gmail.com>:
>>
>>> I’d like to setup an example repo so it’ll build a website (i.e. Github
>>> Pages) where the samples could be run. It seems similar to tourjs in a
>>>way,
>>> but different. “Examples” to me is more like a tutorial on how to use
>>> Royale while tourjs is more of a reference of the components. They seem
>>> separate and complimentary.
>>>
>>> Harbs
>>>
>>>
>>> > On Oct 2, 2017, at 9:25 PM, Peter Ent <pe...@adobe.com.INVALID> wrote:
>>> >
>>> > I have been thinking that examples should be moved from royale-asjs
>>>and
>>> > put into its own royals-examples repo and then a wiki for that would
>>>work
>>> > well.
>>> >
>>> > Maybe the tourjs should be a subdirectory in examples.
>>> >
>>> > ‹peter
>>> >
>>> > On 10/2/17, 2:14 PM, "Harbs" <ha...@gmail.com> wrote:
>>> >
>>> >> INFRA just informed us that Github Wikis are now an option and they
>>>want
>>> >> to know which repos we want wikis for.[1]
>>> >>
>>> >> royale-asjs and royale-compiler seem like no-brainers.
>>> >>
>>> >> What about royale-typedefs, royale-tourjs and royale-website? Does
>>> anyone
>>> >> see a reason for a wiki in those?
>>> >>
>>> >> At what point do folks think we should set up an ³examples² repo? A
>>>wiki
>>> >> would probably be appropriate on something like that.
>>> >>
>>> >> Thanks,
>>> >> Harbs
>>> >>
>>> >> [1]https://na01.safelinks.protection.outlook.com/?url=
>>> https%3A%2F%2Fissues
>>> >> .apache.org%2Fjira%2Fbrowse%2FINFRA-15138%
>>> 3FfocusedCommentId%3D16188401%26
>>> >> page%3Dcom.atlassian.jira.plugin.system.issuetabpanels%
>>> 3Acomment-tabpanel%
>>> >> 23comment-16188401&data=02%7C01%7C%7Cf13e83a4f7594535bec608d509c1
>>> 76d8%7Cfa
>>> >> 7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425648884686688&
>>> sdata=%2FSBh%2
>>> >> BpyjIfrx%2FcwnFZAxqD%2FGdT3lvte6%2FWItPQDTIqs%3D&reserved=0
>>> >
>>>
>>>
>>
>>
>>--
>>
>>Piotr Zarzycki
>>
>>mobile: +48 880 859 557
>>skype: zarzycki10
>>
>>LinkedIn:
>>https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.linke
>>d
>>in.com%2Fpiotrzarzycki&data=02%7C01%7C%7Cd35f8e77a8984d6848e908d509c5e80c
>>%
>>7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425667965210452&sdata=Ql8
>>Z
>>4IdyCQY35l2AYY3z4eqyD%2FpivpLCynsdjE%2FtMbs%3D&reserved=0
>><https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fpl.link
>>e
>>din.com%2Fin%2Fpiotr-zarzycki-92a53552&data=02%7C01%7C%7Cd35f8e77a8984d68
>>4
>>8e908d509c5e80c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425667965
>>2
>>10452&sdata=lkdYzVxCTHWetc1OmKCaiocTfw0V5X%2B8LPea7%2FW8p68%3D&reserved=0
>>>
>>
>>GitHub:
>>https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.c
>>o
>>m%2Fpiotrzarzycki21&data=02%7C01%7C%7Cd35f8e77a8984d6848e908d509c5e80c%7C
>>f
>>a7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425667965210452&sdata=dBsp9j
>>p
>>WZxrjIXSeskOWWC0w4B74rlkvd7lWJgOmRFw%3D&reserved=0
>
Re: Github wikis
Posted by Peter Ent <pe...@adobe.com.INVALID>.
I was thinking that examples should be upstream from the sdk. They are now
in that they cannot be built with the sdk created first.
However, the examples aren't actually "products" where you could agree the
tour is. If we introduce a new component there would be an example created
for it. If the tour could make use it, we would update the tour - at some
point.
So I guess I retract my suggestion of making examples its own repo.
—peter
On 10/2/17, 2:46 PM, "Piotr Zarzycki" <pi...@gmail.com> wrote:
>Hi,
>
>I don't see to much reason for having royale-website wiki - as long as we
>decide where actually documentation goes.
>
>Another repo for examples, does examples which we already have ?
>
>I believe that is good that we are shipping examples along with our
>framework repo - How we will ship that ?
>
>Piotr
>
>
>
>2017-10-02 20:32 GMT+02:00 Harbs <ha...@gmail.com>:
>
>> I’d like to setup an example repo so it’ll build a website (i.e. Github
>> Pages) where the samples could be run. It seems similar to tourjs in a
>>way,
>> but different. “Examples” to me is more like a tutorial on how to use
>> Royale while tourjs is more of a reference of the components. They seem
>> separate and complimentary.
>>
>> Harbs
>>
>>
>> > On Oct 2, 2017, at 9:25 PM, Peter Ent <pe...@adobe.com.INVALID> wrote:
>> >
>> > I have been thinking that examples should be moved from royale-asjs
>>and
>> > put into its own royals-examples repo and then a wiki for that would
>>work
>> > well.
>> >
>> > Maybe the tourjs should be a subdirectory in examples.
>> >
>> > ‹peter
>> >
>> > On 10/2/17, 2:14 PM, "Harbs" <ha...@gmail.com> wrote:
>> >
>> >> INFRA just informed us that Github Wikis are now an option and they
>>want
>> >> to know which repos we want wikis for.[1]
>> >>
>> >> royale-asjs and royale-compiler seem like no-brainers.
>> >>
>> >> What about royale-typedefs, royale-tourjs and royale-website? Does
>> anyone
>> >> see a reason for a wiki in those?
>> >>
>> >> At what point do folks think we should set up an ³examples² repo? A
>>wiki
>> >> would probably be appropriate on something like that.
>> >>
>> >> Thanks,
>> >> Harbs
>> >>
>> >> [1]https://na01.safelinks.protection.outlook.com/?url=
>> https%3A%2F%2Fissues
>> >> .apache.org%2Fjira%2Fbrowse%2FINFRA-15138%
>> 3FfocusedCommentId%3D16188401%26
>> >> page%3Dcom.atlassian.jira.plugin.system.issuetabpanels%
>> 3Acomment-tabpanel%
>> >> 23comment-16188401&data=02%7C01%7C%7Cf13e83a4f7594535bec608d509c1
>> 76d8%7Cfa
>> >> 7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425648884686688&
>> sdata=%2FSBh%2
>> >> BpyjIfrx%2FcwnFZAxqD%2FGdT3lvte6%2FWItPQDTIqs%3D&reserved=0
>> >
>>
>>
>
>
>--
>
>Piotr Zarzycki
>
>mobile: +48 880 859 557
>skype: zarzycki10
>
>LinkedIn:
>https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.linked
>in.com%2Fpiotrzarzycki&data=02%7C01%7C%7Cd35f8e77a8984d6848e908d509c5e80c%
>7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425667965210452&sdata=Ql8Z
>4IdyCQY35l2AYY3z4eqyD%2FpivpLCynsdjE%2FtMbs%3D&reserved=0
><https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fpl.linke
>din.com%2Fin%2Fpiotr-zarzycki-92a53552&data=02%7C01%7C%7Cd35f8e77a8984d684
>8e908d509c5e80c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C6364256679652
>10452&sdata=lkdYzVxCTHWetc1OmKCaiocTfw0V5X%2B8LPea7%2FW8p68%3D&reserved=0>
>
>GitHub:
>https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.co
>m%2Fpiotrzarzycki21&data=02%7C01%7C%7Cd35f8e77a8984d6848e908d509c5e80c%7Cf
>a7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425667965210452&sdata=dBsp9jp
>WZxrjIXSeskOWWC0w4B74rlkvd7lWJgOmRFw%3D&reserved=0
Re: Github wikis
Posted by Piotr Zarzycki <pi...@gmail.com>.
Hi,
I don't see to much reason for having royale-website wiki - as long as we
decide where actually documentation goes.
Another repo for examples, does examples which we already have ?
I believe that is good that we are shipping examples along with our
framework repo - How we will ship that ?
Piotr
2017-10-02 20:32 GMT+02:00 Harbs <ha...@gmail.com>:
> I’d like to setup an example repo so it’ll build a website (i.e. Github
> Pages) where the samples could be run. It seems similar to tourjs in a way,
> but different. “Examples” to me is more like a tutorial on how to use
> Royale while tourjs is more of a reference of the components. They seem
> separate and complimentary.
>
> Harbs
>
>
> > On Oct 2, 2017, at 9:25 PM, Peter Ent <pe...@adobe.com.INVALID> wrote:
> >
> > I have been thinking that examples should be moved from royale-asjs and
> > put into its own royals-examples repo and then a wiki for that would work
> > well.
> >
> > Maybe the tourjs should be a subdirectory in examples.
> >
> > ‹peter
> >
> > On 10/2/17, 2:14 PM, "Harbs" <ha...@gmail.com> wrote:
> >
> >> INFRA just informed us that Github Wikis are now an option and they want
> >> to know which repos we want wikis for.[1]
> >>
> >> royale-asjs and royale-compiler seem like no-brainers.
> >>
> >> What about royale-typedefs, royale-tourjs and royale-website? Does
> anyone
> >> see a reason for a wiki in those?
> >>
> >> At what point do folks think we should set up an ³examples² repo? A wiki
> >> would probably be appropriate on something like that.
> >>
> >> Thanks,
> >> Harbs
> >>
> >> [1]https://na01.safelinks.protection.outlook.com/?url=
> https%3A%2F%2Fissues
> >> .apache.org%2Fjira%2Fbrowse%2FINFRA-15138%
> 3FfocusedCommentId%3D16188401%26
> >> page%3Dcom.atlassian.jira.plugin.system.issuetabpanels%
> 3Acomment-tabpanel%
> >> 23comment-16188401&data=02%7C01%7C%7Cf13e83a4f7594535bec608d509c1
> 76d8%7Cfa
> >> 7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425648884686688&
> sdata=%2FSBh%2
> >> BpyjIfrx%2FcwnFZAxqD%2FGdT3lvte6%2FWItPQDTIqs%3D&reserved=0
> >
>
>
--
Piotr Zarzycki
mobile: +48 880 859 557
skype: zarzycki10
LinkedIn: http://www.linkedin.com/piotrzarzycki
<https://pl.linkedin.com/in/piotr-zarzycki-92a53552>
GitHub: https://github.com/piotrzarzycki21
Re: Github wikis
Posted by Harbs <ha...@gmail.com>.
I’d like to setup an example repo so it’ll build a website (i.e. Github Pages) where the samples could be run. It seems similar to tourjs in a way, but different. “Examples” to me is more like a tutorial on how to use Royale while tourjs is more of a reference of the components. They seem separate and complimentary.
Harbs
> On Oct 2, 2017, at 9:25 PM, Peter Ent <pe...@adobe.com.INVALID> wrote:
>
> I have been thinking that examples should be moved from royale-asjs and
> put into its own royals-examples repo and then a wiki for that would work
> well.
>
> Maybe the tourjs should be a subdirectory in examples.
>
> ‹peter
>
> On 10/2/17, 2:14 PM, "Harbs" <ha...@gmail.com> wrote:
>
>> INFRA just informed us that Github Wikis are now an option and they want
>> to know which repos we want wikis for.[1]
>>
>> royale-asjs and royale-compiler seem like no-brainers.
>>
>> What about royale-typedefs, royale-tourjs and royale-website? Does anyone
>> see a reason for a wiki in those?
>>
>> At what point do folks think we should set up an ³examples² repo? A wiki
>> would probably be appropriate on something like that.
>>
>> Thanks,
>> Harbs
>>
>> [1]https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fissues
>> .apache.org%2Fjira%2Fbrowse%2FINFRA-15138%3FfocusedCommentId%3D16188401%26
>> page%3Dcom.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel%
>> 23comment-16188401&data=02%7C01%7C%7Cf13e83a4f7594535bec608d509c176d8%7Cfa
>> 7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425648884686688&sdata=%2FSBh%2
>> BpyjIfrx%2FcwnFZAxqD%2FGdT3lvte6%2FWItPQDTIqs%3D&reserved=0
>
Re: Github wikis
Posted by Peter Ent <pe...@adobe.com.INVALID>.
I have been thinking that examples should be moved from royale-asjs and
put into its own royals-examples repo and then a wiki for that would work
well.
Maybe the tourjs should be a subdirectory in examples.
‹peter
On 10/2/17, 2:14 PM, "Harbs" <ha...@gmail.com> wrote:
>INFRA just informed us that Github Wikis are now an option and they want
>to know which repos we want wikis for.[1]
>
>royale-asjs and royale-compiler seem like no-brainers.
>
>What about royale-typedefs, royale-tourjs and royale-website? Does anyone
>see a reason for a wiki in those?
>
>At what point do folks think we should set up an ³examples² repo? A wiki
>would probably be appropriate on something like that.
>
>Thanks,
>Harbs
>
>[1]https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fissues
>.apache.org%2Fjira%2Fbrowse%2FINFRA-15138%3FfocusedCommentId%3D16188401%26
>page%3Dcom.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel%
>23comment-16188401&data=02%7C01%7C%7Cf13e83a4f7594535bec608d509c176d8%7Cfa
>7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636425648884686688&sdata=%2FSBh%2
>BpyjIfrx%2FcwnFZAxqD%2FGdT3lvte6%2FWItPQDTIqs%3D&reserved=0