You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@royale.apache.org by Andrew Wetmore <co...@gmail.com> on 2019/12/19 19:36:44 UTC
Changes to Royale Help Docs
Hi:
@carlosrovira and I are evolving the help docs, so you may see some changes
each time you check them. For example, I have migrated information on
Royale Layouts from the old FlexJS cwiki [1].
I have created a project board in the GitHub repository to help me keep
track of tasks as I create doc pages, populate them, and then add them to
the table of contents. You can review that to see what the current work and
the backlog look like, and can also add cards if you think of stuff we
should add to the help docs [2].
This also means that the table of contents will be changing. At the moment
there are some duplications; I will clean them up as time permits.
Please let me know if you run into broken links or if material you expect
to be in the help docs seems to have disappeared.
Andrew
[1] https://apache.github.io/royale-docs/user-interface/layouts.html
[2] https://github.com/apache/royale-docs/projects/2
--
Andrew Wetmore
Re: Changes to Royale Help Docs
Posted by Carlos Rovira <ca...@apache.org>.
It resolves to the same HTML structure, but is more easy to edit since is
like to write AS3 vs JS. You get a more clean text instead so many ugly
html tags ;-)
El jue., 26 dic. 2019 a las 16:36, Andrew Wetmore (<co...@gmail.com>)
escribió:
> I can; but is one any better/clearer/more efficient than the other?
>
> On Thu, Dec 26, 2019 at 11:34 AM Carlos Rovira <ca...@apache.org>
> wrote:
>
> > Hi Andrew
> >
> > just a detail for URLs:
> >
> > we should promote this kind of mark down urls:
> >
> > [Loading external data through HTTPService](
> >
> >
> https://royale.apache.org/loading-external-data-through-httpservice/){:target='_blank
> > '}
> >
> >
> > instead of regular HTML like this:
> >
> > <a href="
> > https://royale.apache.org/loading-external-data-through-httpservice/"
> > target
> > ="_blank">Loading external data through HTTPService</a>
> >
> >
> >
> > El vie., 20 dic. 2019 a las 15:16, Carlos Rovira (<
> carlosrovira@apache.org
> > >)
> > escribió:
> >
> > > Hi,
> > > good idea. I tried to add it to the template so all pages get
> > > automatically the latest modified date time tamp
> > >
> > > Unfortunately, seems GitHub Pages still doesn't support this plugin at
> > the
> > > moment
> > >
> > > Will need to wait, hope it support it soon since I think that is needed
> > >
> > > thanks!
> > >
> > > Carlos
> > >
> > >
> > >
> >
> > --
> > Carlos Rovira
> > http://about.me/carlosrovira
> >
>
>
> --
> Andrew Wetmore
>
> http://cottage14.blogspot.com/
>
--
Carlos Rovira
http://about.me/carlosrovira
Re: Changes to Royale Help Docs
Posted by Andrew Wetmore <co...@gmail.com>.
I can; but is one any better/clearer/more efficient than the other?
On Thu, Dec 26, 2019 at 11:34 AM Carlos Rovira <ca...@apache.org>
wrote:
> Hi Andrew
>
> just a detail for URLs:
>
> we should promote this kind of mark down urls:
>
> [Loading external data through HTTPService](
>
> https://royale.apache.org/loading-external-data-through-httpservice/){:target='_blank
> '}
>
>
> instead of regular HTML like this:
>
> <a href="
> https://royale.apache.org/loading-external-data-through-httpservice/"
> target
> ="_blank">Loading external data through HTTPService</a>
>
>
>
> El vie., 20 dic. 2019 a las 15:16, Carlos Rovira (<carlosrovira@apache.org
> >)
> escribió:
>
> > Hi,
> > good idea. I tried to add it to the template so all pages get
> > automatically the latest modified date time tamp
> >
> > Unfortunately, seems GitHub Pages still doesn't support this plugin at
> the
> > moment
> >
> > Will need to wait, hope it support it soon since I think that is needed
> >
> > thanks!
> >
> > Carlos
> >
> >
> >
>
> --
> Carlos Rovira
> http://about.me/carlosrovira
>
--
Andrew Wetmore
http://cottage14.blogspot.com/
Re: Changes to Royale Help Docs
Posted by Carlos Rovira <ca...@apache.org>.
Hi Andrew
just a detail for URLs:
we should promote this kind of mark down urls:
[Loading external data through HTTPService](
https://royale.apache.org/loading-external-data-through-httpservice/){:target='_blank'}
instead of regular HTML like this:
<a href="
https://royale.apache.org/loading-external-data-through-httpservice/" target
="_blank">Loading external data through HTTPService</a>
El vie., 20 dic. 2019 a las 15:16, Carlos Rovira (<ca...@apache.org>)
escribió:
> Hi,
> good idea. I tried to add it to the template so all pages get
> automatically the latest modified date time tamp
>
> Unfortunately, seems GitHub Pages still doesn't support this plugin at the
> moment
>
> Will need to wait, hope it support it soon since I think that is needed
>
> thanks!
>
> Carlos
>
>
>
--
Carlos Rovira
http://about.me/carlosrovira
Re: Changes to Royale Help Docs
Posted by Carlos Rovira <ca...@apache.org>.
Hi,
good idea. I tried to add it to the template so all pages get automatically
the latest modified date time tamp
Unfortunately, seems GitHub Pages still doesn't support this plugin at the
moment
Will need to wait, hope it support it soon since I think that is needed
thanks!
Carlos
Re: Changes to Royale Help Docs
Posted by Andrew Wetmore <co...@gmail.com>.
That's a good idea!
On Thu, Dec 19, 2019 at 8:53 PM Antonis Kalodimos <
antonis.kalodimos@gmail.com> wrote:
> I suggest somehow to be putted a last update datetime somewhere in the
> site, even for small changes in docs for someone it would looks that is
> active and currently updated
>
> Στις Πέμ, 19 Δεκ 2019 στις 9:37 μ.μ., ο/η Andrew Wetmore <
> cottage14@gmail.com> έγραψε:
>
> > Hi:
> >
> > @carlosrovira and I are evolving the help docs, so you may see some
> changes
> > each time you check them. For example, I have migrated information on
> > Royale Layouts from the old FlexJS cwiki [1].
> >
> > I have created a project board in the GitHub repository to help me keep
> > track of tasks as I create doc pages, populate them, and then add them to
> > the table of contents. You can review that to see what the current work
> and
> > the backlog look like, and can also add cards if you think of stuff we
> > should add to the help docs [2].
> >
> > This also means that the table of contents will be changing. At the
> moment
> > there are some duplications; I will clean them up as time permits.
> >
> > Please let me know if you run into broken links or if material you expect
> > to be in the help docs seems to have disappeared.
> >
> > Andrew
> >
> >
> >
> > [1] https://apache.github.io/royale-docs/user-interface/layouts.html
> >
> > [2] https://github.com/apache/royale-docs/projects/2
> >
> >
> >
> >
> > --
> > Andrew Wetmore
> >
>
--
Andrew Wetmore
http://cottage14.blogspot.com/
Re: Changes to Royale Help Docs
Posted by Antonis Kalodimos <an...@gmail.com>.
I suggest somehow to be putted a last update datetime somewhere in the
site, even for small changes in docs for someone it would looks that is
active and currently updated
Στις Πέμ, 19 Δεκ 2019 στις 9:37 μ.μ., ο/η Andrew Wetmore <
cottage14@gmail.com> έγραψε:
> Hi:
>
> @carlosrovira and I are evolving the help docs, so you may see some changes
> each time you check them. For example, I have migrated information on
> Royale Layouts from the old FlexJS cwiki [1].
>
> I have created a project board in the GitHub repository to help me keep
> track of tasks as I create doc pages, populate them, and then add them to
> the table of contents. You can review that to see what the current work and
> the backlog look like, and can also add cards if you think of stuff we
> should add to the help docs [2].
>
> This also means that the table of contents will be changing. At the moment
> there are some duplications; I will clean them up as time permits.
>
> Please let me know if you run into broken links or if material you expect
> to be in the help docs seems to have disappeared.
>
> Andrew
>
>
>
> [1] https://apache.github.io/royale-docs/user-interface/layouts.html
>
> [2] https://github.com/apache/royale-docs/projects/2
>
>
>
>
> --
> Andrew Wetmore
>