Mailing-List: contact dev-help@royale.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@royale.apache.org
Content-Type: text/plain; charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 8.2 \(2104\))
Subject: Re: Github Pages (was Re: Github wikis)
From: Harbs <harbs.lists@gmail.com>
In-Reply-To: <CAP37iKHuuCDWA5w+AD7rD8rnnRSp_OcDCJGeWwOJNTHCOST4iw@mail.gmail.com>
Date: Wed, 4 Oct 2017 12:55:59 +0300
Content-Transfer-Encoding: quoted-printable
Message-Id: <823EF6D7-0D78-4A7D-AE92-062C61769C92@gmail.com>
References: <D5F875DC.A6C8C%aharui@adobe.com> <CACK5iZcfSa=kR+KcstQHZhRfntFZVc8B0gFvOw76KDCLGoBivA@mail.gmail.com> <69DB7883-7AEE-42FC-9B02-012EC396AF0C@gmail.com> <CAP37iKHOrfFMTY9fcjwsv221o9YhjfJ8B07ruYdF9T30nOtkHg@mail.gmail.com> <D5F93E2E.A76CF%aharui@adobe.com> <D5F94256.A7761%aharui@adobe.com> <4E0D8C1A-179B-4EC9-A231-7B205B8DBFFF@gmail.com> <DM5PR02MB33076932CB129E8D138B69BADE720@DM5PR02MB3307.namprd02.prod.outlook.com> <CACK5iZcuv0AdpgVVOyQ7QU9GYRq29k9X7P1kH_GgV7HPG4jVrA@mail.gmail.com> <D5F9D1C0.A7DA9%aharui@adobe.com> <9ADDF630-1763-4483-9248-BA12A6DD0685@gmail.com> <CAP37iKEUw-9hwvMyCcBwu7wfL=y_4TOpkscbF3gNVfMDWRR14A@mail.gmail.com> <9FD53240-71B0-4364-A7DF-3AC3109901E3@gmail.com> <CAP37iKHuuCDWA5w+AD7rD8rnnRSp_OcDCJGeWwOJNTHCOST4iw@mail.gmail.com>
To: dev@royale.apache.org
archived-at: Wed, 04 Oct 2017 09:56:09 -0000

Thanks.

The structure there and a lot of the content is great.

We should definitely copy it into docs. We should probably figure out =
the best way to write the docs and get started=E2=80=A6 ;-)

I just added a link to his wiki from the docs page for now.

Does anyone think we need a wiki for the docs repo?

Harbs
> On Oct 4, 2017, at 10:07 AM, Piotr Zarzycki =
<piotrzarzycki21@gmail.com> wrote:
>=20
> Here you go -> https://github.com/ok-at-github/flexjs-docs/wiki
>=20
> Thanks,
> Piotr
>=20
> 2017-10-04 9:04 GMT+02:00 Harbs <harbs.lists@gmail.com>:
>=20
>> I can=E2=80=99t find Olaf=E2=80=99s wiki. Remind me of the URL?
>>=20
>>> On Oct 4, 2017, at 9:59 AM, Piotr Zarzycki =
<piotrzarzycki21@gmail.com>
>> wrote:
>>>=20
>>> Thanks Alex. I'm just asking cause I was thinking where I can start =
with
>>> all of that. I believe that documentation is our true weak point.
>>>=20
>>> Harbs do you have some plans in case of the docs ? Do you think that
>> Olaf's
>>> work can be used ?
>>>=20
>>> Piotr
>>>=20
>>> 2017-10-04 8:54 GMT+02:00 Harbs <harbs.lists@gmail.com <mailto:
>> harbs.lists@gmail.com>>:
>>>=20
>>>> I believe we can have it available at a different URL (i.e.
>>>> royalesdk.org/docs <http://royalesdk.org/docs> <
>> http://royalesdk.org/docs <http://royalesdk.org/docs>>) using CNAME
>> entries:
>>>> https://help.github.com/articles/using-a-custom-
>> domain-with-github-pages/ <https://help.github.com/
>> articles/using-a-custom-domain-with-github-pages/>
>>>> <https://help.github.com/articles/using-a-custom-
>> domain-with-github-pages/
>>>>>=20
>>>>=20
>>>>> On Oct 4, 2017, at 9:48 AM, Alex Harui <aharui@adobe.com.INVALID>
>> wrote:
>>>>>=20
>>>>> I'm not sure we have that choice.  I think we are part of an
>> organization
>>>>> and have to use a separate repo.  Maybe that's better because we =
have
>>>>> several code repos.
>>>>>=20
>>>>> The repo is:
>>>>>=20
>>>>> https://github.com/apache/royale-docs
>>>>>=20
>>>>> When you push it becomes available here:
>>>>>=20
>>>>> https://apache.github.io/royale-docs/
>>>>>=20
>>>>> Of course, I could be wrong...
>>>>> -Alex
>>>>>=20
>>>>> On 10/3/17, 4:46 PM, "omuppi1@gmail.com on behalf of OmPrakash
>>>> Muppirala"
>>>>> <omuppi1@gmail.com on behalf of bigosmallm@gmail.com> wrote:
>>>>>=20
>>>>>> This should make things simpler:
>>>>>> https://na01.safelinks.protection.outlook.com/?url=3D
>>>> https%3A%2F%2Fgithub.co
>>>>>> m%2Fblog%2F2228-simpler-github-pages-publishing&data=3D
>>>> 02%7C01%7C%7Cdfa4e446
>>>>>> 61f04aca4c1a08d50ad92538%7Cfa7b1b5a7b34438794aed2c178de
>>>> cee1%7C0%7C0%7C6364
>>>>>> 26850111393184&sdata=3D6FAJXFa81NJY%2FG7FHdKpbnZq3N8arcYV1reW1uDWl
>>>> VQ%3D&rese
>>>>>> rved=3D0
>>>>>>=20
>>>>>> Thanks,
>>>>>> Om
>>>>>>=20
>>>>>> On Tue, Oct 3, 2017 at 2:57 PM, Alex Harui =
<aharui@adobe.com.invalid>
>>>>>> wrote:
>>>>>>=20
>>>>>>> Not sure. I  notified infra per their instructions.
>>>>>>>=20
>>>>>>> Get Outlook for
>>>>>>> Android<https://na01.safelinks.protection.outlook.
>>>> com/?url=3Dhttps%3A%2F%2F
>>>>>>> aka.ms%2Fghei36&data=3D02%7C01%7C%7Cdfa4e44661f04aca4c1a08d50ad9
>>>> 2538%7Cfa7b
>>>>>>> 1b5a7b34438794aed2c178decee1%7C0%7C0%7C636426850111393184&
>>>> sdata=3D0KYVTdYNd
>>>>>>> hKvtS%2B3Ny28BrSOUjdZWdxFcLXkyO4T3wY%3D&reserved=3D0>
>>>>>>>=20
>>>>>>> ________________________________
>>>>>>> From: Harbs <harbs.lists@gmail.com>
>>>>>>> Sent: Tuesday, October 3, 2017 1:46:14 PM
>>>>>>> To: dev@royale.apache.org
>>>>>>> Subject: Re: Github Pages (was Re: Github wikis)
>>>>>>>=20
>>>>>>> Done. Do I need to make a gh-pages branch?
>>>>>>>=20
>>>>>>>> On Oct 3, 2017, at 11:35 PM, Alex Harui =
<aharui@adobe.com.INVALID>
>>>>>>> wrote:
>>>>>>>>=20
>>>>>>>> Royale-docs has been created.  Can someone put in some initial
>>>>>>> content?
>>>>>>>> I'm buried in the rename and don't want to stop to figure out =
GH
>>>>>>> Pages.
>>>>>>>> Then we ask Infra to hook it up as our project's pages.
>>>>>>>>=20
>>>>>>>> Thanks,
>>>>>>>> -Alex
>>>>>>>>=20
>>>>>>>> On 10/3/17, 1:17 PM, "Alex Harui" <aharui@adobe.com.INVALID> =
wrote:
>>>>>>>>=20
>>>>>>>>> OK, put in a request for royale-docs.
>>>>>>>>>=20
>>>>>>>>> On 10/3/17, 1:07 AM, "Piotr Zarzycki" =
<piotrzarzycki21@gmail.com>
>>>>>>> wrote:
>>>>>>>>>=20
>>>>>>>>>> Hi Alex,
>>>>>>>>>>=20
>>>>>>>>>> +1 for royale-docs. If I would like to make something like =
Olaf
>> [1]
>>>>>>>>>> started
>>>>>>>>>> and move all his already gathered information in that =
structure
>>>>>>> where
>>>>>>> in
>>>>>>>>>> your opinion guys should it go ? Into the royale-docs as gh =
pages
>> or
>>>>>>> into
>>>>>>>>>> royale-asjs as Wiki ?
>>>>>>>>>>=20
>>>>>>>>>> Does anyone is against to have it Olaf's work as an starting
>> point ?
>>>>>>>>>>=20
>>>>>>>>>> [1]
>>>>>>>>>> https://na01.safelinks.protection.outlook.com/?url=3D
>>>>>>> https%3A%2F%2Fgithub.c
>>>>>>>>>> o
>>>>>>>>>> m%2Fok-at-github%2Fflexjs-docs%2Fwiki&data=3D02%7C01%7C%
>>>>>>> 7C88a0571d57dc4f6ed
>>>>>>>>>> 2
>>>>>>>>>> b708d50a35c2c1%7Cfa7b1b5a7b34438794aed2c178de
>>>>>>> cee1%7C0%7C0%7C6364261483757
>>>>>>>>>> 2
>>>>>>>>>>=20
>>>>>>> 6455&sdata=3DKFmOxwgKRbgCW5LTjF0xy8UG%2B6wPjyc744lJ9KTdy00%3D&
>> reserved=3D0
>>>>>>>>>>=20
>>>>>>>>>> Thanks,
>>>>>>>>>> Piotr
>>>>>>>>>>=20
>>>>>>>>>>=20
>>>>>>>>>> 2017-10-03 9:55 GMT+02:00 Harbs <harbs.lists@gmail.com>:
>>>>>>>>>>=20
>>>>>>>>>>> royale-docs is good.
>>>>>>>>>>>=20
>>>>>>>>>>>> On Oct 3, 2017, at 9:36 AM, OmPrakash Muppirala
>>>>>>>>>>> <bigosmallm@gmail.com>
>>>>>>>>>>> wrote:
>>>>>>>>>>>>=20
>>>>>>>>>>>> I prefer royale-docs
>>>>>>>>>>>>=20
>>>>>>>>>>>> Thanks,
>>>>>>>>>>>> Om
>>>>>>>>>>>>=20
>>>>>>>>>>>> On Oct 2, 2017 11:04 PM, "Alex Harui" =
<aharui@adobe.com.invalid
>>>=20
>>>>>>>>>>> wrote:
>>>>>>>>>>>>=20
>>>>>>>>>>>>> Per Infra:  "Pages are not enabled until we have some =
content
>> to
>>>>>>>>>>> point
>>>>>>>>>>> to.
>>>>>>>>>>>>> Best thing I think is to create a new royale-pages =
repository
>> (or
>>>>>>>>>>> whatever
>>>>>>>>>>>>> name) and I'll enable it on that - ensure some content in
>>>>>>> 'master'
>>>>>>>>>>> branch
>>>>>>>>>>>>> or 'master/docs' . those pages would then be available on
>>>>>>>>>>>>> apache.github.io/royale-pages (or whatever)"
>>>>>>>>>>>>>=20
>>>>>>>>>>>>> Shall we create a royale-pages repo?  Anybody think it =
should
>>>>>>> have
>>>>>>>>>>> some
>>>>>>>>>>>>> other name?  "royale-documentation"?  I think it will hold =
our
>>>>>>>>>>> non-ASDoc
>>>>>>>>>>>>> user documentation.
>>>>>>>>>>>>>=20
>>>>>>>>>>>>> Thoughts?
>>>>>>>>>>>>> -Alex
>>>>>>>>>>>>>=20
>>>>>>>>>>>>> On 10/2/17, 11:42 AM, "Alex Harui" =
<aharui@adobe.com.INVALID>
>>>>>>> wrote:
>>>>>>>>>>>>>=20
>>>>>>>>>>>>>> I think I learned that Github Pages is not per-repo, it =
is one
>>>>>>> per
>>>>>>>>>>> Apache
>>>>>>>>>>>>>> Project.
>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>> 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.
>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>> My 2 cents,
>>>>>>>>>>>>>> -Alex
>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>> On 10/2/17, 11:32 AM, "Harbs" <harbs.lists@gmail.com> =
wrote:
>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>> I=E2=80=99d like to setup an example repo so it=E2=80=99ll=
 build a website
>>>>>>> (i.e.
>>>>>>>>>>> Github
>>>>>>>>>>>>>>> Pages) where the samples could be run. It seems similar =
to
>>>>>>> tourjs
>>>>>>>>>>> in a
>>>>>>>>>>>>>>> way, but different. =E2=80=9CExamples=E2=80=9D 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.
>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>> Harbs
>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>> On Oct 2, 2017, at 9:25 PM, Peter Ent
>> <pent@adobe.com.INVALID
>>>>>=20
>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>> 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.
>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>> Maybe the tourjs should be a subdirectory in examples.
>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>> =E2=80=B9peter
>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>> On 10/2/17, 2:14 PM, "Harbs" <harbs.lists@gmail.com> =
wrote:
>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> INFRA just informed us that Github Wikis are now an =
option
>>>>>>> and
>>>>>>>>>>> they
>>>>>>>>>>>>>>>>> want
>>>>>>>>>>>>>>>>> to know which repos we want wikis for.[1]
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> royale-asjs and royale-compiler seem like no-brainers.
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> What about royale-typedefs, royale-tourjs and
>> royale-website?
>>>>>>>>>>> Does
>>>>>>>>>>>>>>>>> anyone
>>>>>>>>>>>>>>>>> see a reason for a wiki in those?
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> At what point do folks think we should set up an =
=C2=B3examples=C2=B2
>>>>>>>>>>> repo? A
>>>>>>>>>>>>>>>>> wiki
>>>>>>>>>>>>>>>>> would probably be appropriate on something like that.
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>>>>> Harbs
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> [1]https://na01.safelinks.protection.outlook.com/?url=3D=

>>>>>>>>>>>>> https%3A%2F%2Fiss
>>>>>>>>>>>>>>>>> u
>>>>>>>>>>>>>>>>> es
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> .apache.org%2Fjira%2Fbrowse%2FINFRA-15138%
>>>>>>>>>>>>> 3FfocusedCommentId%3D16188401
>>>>>>>>>>>>>>>>> %
>>>>>>>>>>>>>>>>> 26
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> =
page%3Dcom.atlassian.jira.plugin.system.issuetabpanels%
>>>>>>>>>>>>> 3Acomment-tabpan
>>>>>>>>>>>>>>>>> e
>>>>>>>>>>>>>>>>> l%
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>> 23comment-16188401&data=3D02%7C01%7C%
>> 7Cf13e83a4f7594535bec608d509c1
>>>>>>>>>>>>> 76d8%7
>>>>>>>>>>>>>>>>> C
>>>>>>>>>>>>>>>>> fa
>>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>>> 7b1b5a7b34438794aed2c178decee1
>> %7C0%7C0%7C636425648884686688&
>>>>>>>>>>>>> sdata=3D%2FSB
>>>>>>>>>>>>>>>>> h
>>>>>>>>>>>>>>>>> %2
>>>>>>>>>>>>>>>>> BpyjIfrx%2FcwnFZAxqD%2FGdT3lvte6%2FWItPQDTIqs%3D&
>> reserved=3D0
>>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>>=20
>>>>>>>>>>>>>=20
>>>>>>>>>>>>>=20
>>>>>>>>>>>=20
>>>>>>>>>>>=20
>>>>>>>>>>=20
>>>>>>>>>>=20
>>>>>>>>>> --
>>>>>>>>>>=20
>>>>>>>>>> Piotr Zarzycki
>>>>>>>>>>=20
>>>>>>>>>> mobile: +48 880 859 557
>>>>>>>>>> skype: zarzycki10
>>>>>>>>>>=20
>>>>>>>>>> LinkedIn:
>>>>>>>>>> https://na01.safelinks.protection.outlook.com/?url=3D
>>>>>>> http%3A%2F%2Fwww.linke
>>>>>>>>>> d
>>>>>>>>>>=20
>>>>>>> in.com%2Fpiotrzarzycki&data=3D02%7C01%7C%
>> 7C88a0571d57dc4f6ed2b708d50a35
>>>>>>> c2c1
>>>>>>>>>> %
>>>>>>>>>> 7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%
>>>>>>> 7C636426148375726455&sdata=3D9Iu
>>>>>>>>>> Y
>>>>>>>>>> zi2Xc7Rn%2Fh7fEhdx3%2FZL2zal8uvnWt7%2BA6XPEIU%3D&reserved=3D0
>>>>>>>>>> <https://na01.safelinks.protection.outlook.com/?url=3D
>>>>>>> https%3A%2F%2Fpl.link
>>>>>>>>>> e
>>>>>>>>>> din.com%2Fin%2Fpiotr-zarzycki-92a53552&data=3D02%7C01%7C%
>>>>>>> 7C88a0571d57dc4f6e
>>>>>>>>>> d
>>>>>>>>>> 2b708d50a35c2c1%7Cfa7b1b5a7b34438794aed2c178de
>>>>>>> cee1%7C0%7C0%7C636426148375
>>>>>>>>>> 7
>>>>>>>>>> 26455&sdata=3D3wTwkWcXwOhMB1ZbnlyTzLL2FJButx
>>>>>>> mx28%2BIbDG80W8%3D&reserved=3D0>
>>>>>>>>>>=20
>>>>>>>>>> GitHub:
>>>>>>>>>> https://na01.safelinks.protection.outlook.com/?url=3D
>>>>>>> https%3A%2F%2Fgithub.c
>>>>>>>>>> o
>>>>>>>>>> m%2Fpiotrzarzycki21&data=3D02%7C01%7C%
>> 7C88a0571d57dc4f6ed2b708d50a35
>>>>>>> c2c1%7C
>>>>>>>>>> f
>>>>>>>>>> a7b1b5a7b34438794aed2c178decee1%7C0%7C0%
>> 7C636426148375726455&sdata=3D
>>>>>>> 9yybfI
>>>>>>>>>> 1
>>>>>>>>>> 8Klsn70VEawLVOTS0Q2lXbuguuBhjDDF1udo%3D&reserved=3D0
>>>>>>>>>=20
>>>>>>>>=20
>>>>>>>=20
>>>>>>>=20
>>>>>=20
>>>>=20
>>>>=20
>>>=20
>>>=20
>>> --
>>>=20
>>> Piotr Zarzycki
>>>=20
>>> mobile: +48 880 859 557
>>> skype: zarzycki10
>>>=20
>>> LinkedIn: http://www.linkedin.com/piotrzarzycki <
>> http://www.linkedin.com/piotrzarzycki>
>>> <https://pl.linkedin.com/in/piotr-zarzycki-92a53552 <
>> https://pl.linkedin.com/in/piotr-zarzycki-92a53552>>
>>>=20
>>> GitHub: https://github.com/piotrzarzycki21 <https://github.com/
>> piotrzarzycki21>
>>=20
>=20
>=20
>=20
> --=20
>=20
> Piotr Zarzycki
>=20
> mobile: +48 880 859 557
> skype: zarzycki10
>=20
> LinkedIn: http://www.linkedin.com/piotrzarzycki
> <https://pl.linkedin.com/in/piotr-zarzycki-92a53552>
>=20
> GitHub: https://github.com/piotrzarzycki21