Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Once we fill enough content we will figure out how to put into the Apache.

Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63890.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[OmPrakash Muppirala]

Ah, I see that Apache org on Github has disabled wiki pages.  Sorry for the
noise :-(

Thanks,
Om

On Mon, Aug 14, 2017 at 11:17 AM, piotrz  wrote:

> Om,
>
> What do you mean by check in those doc to flexjs source ? Do you mean
> create
> in our FlexJS repo [1] similar wiki tab as it is currently on Olaf's github
> ?
>
> [1] https://github.com/apache/flex-asjs
>
> Thanks,
> Piotr
>
>
>
> -
> Apache Flex PMC
> piotrzarzyck...@gmail.com
> --
> View this message in context: http://apache-flex-
> development.247.n4.nabble.com/FlexJS-Docs-Started-with-
> some-docs-using-a-github-repo-tp63786p63887.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.
>

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Om,

What do you mean by check in those doc to flexjs source ? Do you mean create
in our FlexJS repo [1] similar wiki tab as it is currently on Olaf's github
? 

[1] https://github.com/apache/flex-asjs

Thanks,
Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63887.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[OmPrakash Muppirala]

I think Github is a better way to crowd-source documentation than asking
folks to write to a Wiki page.
It enables anyone to start working on documentation and then send a PR.

That said, Olaf, since you are already a committer, you can simply check in
the docs into the flex-asjs git repo and continue working there as well.

Thanks,
Om

On Mon, Aug 14, 2017 at 10:14 AM, Alex Harui 
wrote:

> Note that we can and have given out Apache Flex wiki edit access to
> non-committers.
>
> If the plan is to move this content to Apache someday, it is prudent to
> make sure contributors have agreed to that before contributing.  Having
> this work contributed directly to the Apache Flex wiki implies that
> agreement.
>
> So, I think folks have to decide whether there is some logistical or
> technical advantage to having this content created outside of Apache on a
> different wiki technology or not.  It is important that good doc exists
> within the project.  I think I've seen projects get in trouble for
> pointing folks outside of Apache for the "recommended" doc.  But that does
> not mean that other folks cannot create better content outside of Apache
> and make money writing books and other learning content.
>
> My 2 cents,
> -Alex
>
> On 8/13/17, 12:15 PM, "Olaf Krueger"  wrote:
> >
> >I think the benefit of using GitHub is that anybody is able to contribute,
> >even non-comitters. And that it's not so bad to have some more FlexJS
> >resources on the web.
> >
> >However, it could still move to Apache at any time.
> >
> >Thanks,
> >Olaf
> >
> >
> >
> >
> >
> >
> >
> >
> >--
> >View this message in context:
> >https://na01.safelinks.protection.outlook.com/?url=
> http%3A%2F%2Fapache-fle
> >x-development.247.n4.nabble.com%2FFlexJS-Docs-
> Started-with-some-docs-u
> >sing-a-github-repo-tp63786p63849.html=02%
> 7C01%7C%7Ce00c1eb5621a40a123
> >7908d4e27fe696%7Cfa7b1b5a7b34438794aed2c178de
> cee1%7C0%7C0%7C63638248633420
> >9429=HFsLJjHR94EnZa%2FqKkT%2FJ6bYgh2PM847puWcjQjkLy4%3D=0
> >Sent from the Apache Flex Development mailing list archive at Nabble.com.
>
>

Re: [FlexJS][Docs] Started with some docs using a github repo

[Alex Harui]

Note that we can and have given out Apache Flex wiki edit access to
non-committers.

If the plan is to move this content to Apache someday, it is prudent to
make sure contributors have agreed to that before contributing.  Having
this work contributed directly to the Apache Flex wiki implies that
agreement.

So, I think folks have to decide whether there is some logistical or
technical advantage to having this content created outside of Apache on a
different wiki technology or not.  It is important that good doc exists
within the project.  I think I've seen projects get in trouble for
pointing folks outside of Apache for the "recommended" doc.  But that does
not mean that other folks cannot create better content outside of Apache
and make money writing books and other learning content.

My 2 cents,
-Alex

On 8/13/17, 12:15 PM, "Olaf Krueger"  wrote:
>
>I think the benefit of using GitHub is that anybody is able to contribute,
>even non-comitters. And that it's not so bad to have some more FlexJS
>resources on the web.
>
>However, it could still move to Apache at any time.
>
>Thanks,
>Olaf
>
>
> 
>
>
>
>
>
>--
>View this message in context:
>https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fapache-fle
>x-development.247.n4.nabble.com%2FFlexJS-Docs-Started-with-some-docs-u
>sing-a-github-repo-tp63786p63849.html=02%7C01%7C%7Ce00c1eb5621a40a123
>7908d4e27fe696%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C63638248633420
>9429=HFsLJjHR94EnZa%2FqKkT%2FJ6bYgh2PM847puWcjQjkLy4%3D=0
>Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

Let's just focus on content for now... there's still a way to go ;-)

Olaf



--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63864.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Maybe that's the right way. Move everything from the scratch to Github WIKI
in Apache repo. I will be definitely working on getting as much as I can
filled.

Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63859.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Harbs]

I’m not sure if it’s enough or not. I think you should explicitly make the wiki 
Apache to be totally sure.

> On Aug 13, 2017, at 11:02 PM, Olaf Krueger  wrote:
> 
> OmPrakash Muppirala wrote
>> That said, if you plan to migrate it to the Apache Flex project at a
>> future
>> point, it will be easier if you add an Apache V2 license to your repo
>> right
>> away.
> 
> That was the first thing that I've done after creating the repo [1]
> But cause you mention it I just wonder if that's enough...
> 
> Thanks,
> Olaf
> 
> [1] https://github.com/ok-at-github/flexjs-docs/blob/master/LICENSE
> 
> 
> 
> 
> --
> View this message in context: 
> http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63854.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

OmPrakash Muppirala wrote
> That said, if you plan to migrate it to the Apache Flex project at a
> future
> point, it will be easier if you add an Apache V2 license to your repo
> right
> away.

That was the first thing that I've done after creating the repo [1]
But cause you mention it I just wonder if that's enough...

Thanks,
Olaf

[1] https://github.com/ok-at-github/flexjs-docs/blob/master/LICENSE




--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63854.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[OmPrakash Muppirala]

Olaf,

I think you should do what you feel comfortable given that you are putting
most of the work 

That said, if you plan to migrate it to the Apache Flex project at a future
point, it will be easier if you add an Apache V2 license to your repo right
away.

Thanks,
Om


On Aug 13, 2017 12:17 PM, "Olaf Krueger"  wrote:

>By GitHub pages you mean as part of Apache ?

No. Github pages use Jekyll as static site generator under the hood and
Jekyll supports Markdown to generate the pages.
So the migration should not so much effort.
At the end, each particular article is represented by its particular file
then which could probably be tracked easier.

I think the benefit of using GitHub is that anybody is able to contribute,
even non-comitters. And that it's not so bad to have some more FlexJS
resources on the web.

However, it could still move to Apache at any time.

Thanks,
Olaf








--
View this message in context: http://apache-flex-
development.247.n4.nabble.com/FlexJS-Docs-Started-with-
some-docs-using-a-github-repo-tp63786p63849.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

>By GitHub pages you mean as part of Apache ?

No. Github pages use Jekyll as static site generator under the hood and
Jekyll supports Markdown to generate the pages.
So the migration should not so much effort.
At the end, each particular article is represented by its particular file
then which could probably be tracked easier.

I think the benefit of using GitHub is that anybody is able to contribute,
even non-comitters. And that it's not so bad to have some more FlexJS
resources on the web.

However, it could still move to Apache at any time.

Thanks,
Olaf


 





--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63849.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

By github pages you mean as part of Apache ? I'm not enough familiar with
some of the stuff on github.

Thanks,
Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63848.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

Ups,  overlooked this Post...




--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63846.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

The history you mentioned is of the Home file. 
Take a look at this [1] to see the moonshine history.

Maybe we should move it all sooner to a docs dir and publish it via github
pages.  We probably have better control of all the content then.

HTH, 
Olaf 

[1] https://github.com/ok-at-github/flexjs-docs/wiki/Moonshine-IDE/_history



--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63845.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Something is wrong after vacation with me :) I see revisions now. :) Sorry
for the span :) I will continue filling of wiki.

Thanks,
Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63844.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Olaf,

NVM I figure out how it is working. Another stranger things is that I've
edited Moonshine IDE page, but I don't seen in the revision my changes [1].
Maybe I should be added as contributor ?

[1] https://github.com/ok-at-github/flexjs-docs/wiki/Home/_history

Thanks,
Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63842.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Olaf,

I think I get lost a bit. I've tried edit Moonshine sub page. I clicked on
it and click Edit, but it's appear as an separate page. [1][2]

Why it happened ?

[1] https://github.com/ok-at-github/flexjs-docs/wiki/Moonshine-IDE
[2] https://github.com/ok-at-github/flexjs-docs/wiki/Moonshine

Thanks,
Piotr




-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63836.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Harbs]

One suggestion:

I think you should explicitly set a permissive license to any content on the 
wiki so we can repurpose it however we like without worrying about licensing 
afterwards.

> On Aug 9, 2017, at 2:13 PM, Olaf Krueger  wrote:
> 
> Hi guys,
> it seems to me that since Adobe announced the EOL of FlashPlayer there's
> some more interest in FlexJS.
> And it also seems to me that is still not so easy to get in touch with
> FlexJS for others.
> One reason is probably the lack of the documentation.
> 
> My feeling is that some more documentation is more important than ever at
> this time where folks probably think about which path they will go with
> their Flex apps in future.
> 
> So I prioritized this task for myself and started a github wiki with the
> goal to fill the gap.
> I decide to go with github instead of our wiki cause I think it is easier to
> contribute for anybody who is willing to help.
> Moreover, the long term idea is to move to github pages to provide a shiny
> website dedicated to FlexJS.
> Bootstrap, Angular and others do impressive things using github pages with
> static site generators.
> If it turns out that this approach is helpful and if there are no technical
> issues it could be moved to Apache at any time of course.
> 
> This is the link to the wiki [1].
> For now, it's just a scaffolding of what I would like to achieve at first. A
> lot of things are probably already available at other places but I think it
> is helpful to summarize all these things at one place.
> 
> The repo is not restricted to some collaborators so anybody who's willing to
> help should be able to start right now.
> 
> Thanks,
> Olaf
> 
> [1] https://github.com/ok-at-github/flexjs-docs/wiki 
> 
> 
> 
> 
> --
> View this message in context: 
> http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Harbs]

I meant the “copied JS”, but yes.

> On Aug 11, 2017, at 11:23 PM, Olaf Krueger  wrote:
> 
> Forget about this:
> 
>> The advantage of MXML is that we can declare both JS code and the CSS in
> the same file.
> 
> I think you mean AS instead of JS?!
> 
> Thanks,
> Olaf
> 
> 
> 
> --
> View this message in context: 
> http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63819.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

>Go for it! :-)

Done! [1]
Looking forward to following the steps by myself.
If I'll be successful I'll add a working FlexJS example to the wiki.

Olaf

[1]
https://github.com/ok-at-github/flexjs-docs/wiki/Adapting-HTML-CSS-JS-project




--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63818.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

Forget about this:

>The advantage of MXML is that we can declare both JS code and the CSS in
the same file.

I think you mean AS instead of JS?!

Thanks,
Olaf



--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63819.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Harbs]

Go for it! :-)

> On Aug 11, 2017, at 3:26 PM, Olaf Krueger  wrote:
> 
> This is an awesome tutorial, thanks Harbs!
> Hope I'll have some time to follow these steps by myself.
> 
> However, if I'll get your permission I will definitely help to put in on the
> github wiki.
> 
> Maybe we're also able to build a working example including a live demo... 
> 
> Thanks,
> Olaf
> 
> 
> 
> --
> View this message in context: 
> http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63808.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

This is an awesome tutorial, thanks Harbs!
Hope I'll have some time to follow these steps by myself.

However, if I'll get your permission I will definitely help to put in on the
github wiki.

Maybe we're also able to build a working example including a live demo... 

Thanks,
Olaf



--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63808.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Harbs]

Let’s just focus on getting documentation written for now. It can always be 
re-organized later.

I just wrote what I think is a useful tutorial on using random HTML/CSS/JS. 
This should probably be included somehow…

https://docs.google.com/document/d/1pW599xo-Icys-xXEeNi6tbTcH-iMepbTR6WcviLy7i8/edit?usp=sharing
 


> On Aug 11, 2017, at 9:55 AM, piotrz  wrote:
> 
> Olaf,
> 
> I have in my head that we should some day create such website using FlexJS,
> but it would require some longer time.
> 
> Focusing on your documentation idea is the better one for now. I hope when
> it will be full we could automatically somehow generate some website and
> push to Apache everything. :)
> 
> Thanks,
> Piotr
> 
> 
> 
> -
> Apache Flex PMC
> piotrzarzyck...@gmail.com
> --
> View this message in context: 
> http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63806.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Olaf,

I have in my head that we should some day create such website using FlexJS,
but it would require some longer time.

Focusing on your documentation idea is the better one for now. I hope when
it will be full we could automatically somehow generate some website and
push to Apache everything. :)

Thanks,
Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63806.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

Nicholas Kwiatkowski-2 wrote
> The current site is actually managed by a static-site generator using
> markdown.

What do you think about creating a site that is dedicated to FlexJS?

@Piotr
I've started to put some docs together for the mdl:badge bead. [1]
It's not complete and only a first shot.
Maybe we found some better pattern.
But I think we should find one documentation pattern that we could apply to
all other beads and components that fit for all component sets in the same
way.
I also don't know if it's a good idea to do the documentation of properties
manually... but we have to start with something.

Thanks,
Olaf 

[1] 
https://github.com/ok-at-github/flexjs-docs/wiki/MDL-Badges





--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63805.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Nicholas Kwiatkowski]

Getting a sub-domain isn't a big deal.  We just have to request it from
Apache Infra.  I doubt that getting a domain name hosted elsewhere with the
"apache" name it will fly, though.

The current site is actually managed by a static-site generator using
markdown.  I've jerry-rigged it so that if you post a .html file it won't
mess with it, so you can use FlexJS to generate a page and post it on our
site.

-Nick

On Thu, Aug 10, 2017 at 3:54 AM, Olaf Krueger  wrote:

> Hi Piotr,
>
> >As for the examples maybe it's worth to put them into FlexJS Tour where
> Peter start initial work [1].
> Is this FlexJS Tour already hosted anywhere as a live demo?
>
> >Anyone know whether we could take from Apache some new domain or how to
> put
> it as subpage of our website?
>
> Would be great to have apacheflexjs.org and flexjs.org.
> One long term idea is to use some of these static site generators out there
> to create a shiny website.
> I think a static site is much easier to maintain and it's free of any
> dependencies.
>
>
> >I will start slowly fill MDL part.
> Cool!
> If you'll start I suggest to do it in the same way like the MDL demo:
> They grouped components by its concern and put all components of a group on
> one page with a table of content at the top of the page.
> Regarding the demos, I remember some discussions with Alex with the
> conclusion that it might be better to provide a particular demo by using
> just one file. So it could be easily copied and paste.
> So at the end, we should provide some explanation, mxml, screenshots and a
> link to a working demo for each particular component.
> I'll try to create an example tonight which could be used as template
> maybe.
>
> Enjoy your vacation!
>
> Thanks,
> Olaf
>
>
>
>
>
> --
> View this message in context: http://apache-flex-
> development.247.n4.nabble.com/FlexJS-Docs-Started-with-
> some-docs-using-a-github-repo-tp63786p63800.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.
>

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

Hi Piotr,

>As for the examples maybe it's worth to put them into FlexJS Tour where
Peter start initial work [1].
Is this FlexJS Tour already hosted anywhere as a live demo?

>Anyone know whether we could take from Apache some new domain or how to put
it as subpage of our website? 

Would be great to have apacheflexjs.org and flexjs.org.
One long term idea is to use some of these static site generators out there
to create a shiny website.
I think a static site is much easier to maintain and it's free of any
dependencies.


>I will start slowly fill MDL part.
Cool!
If you'll start I suggest to do it in the same way like the MDL demo:
They grouped components by its concern and put all components of a group on
one page with a table of content at the top of the page.
Regarding the demos, I remember some discussions with Alex with the
conclusion that it might be better to provide a particular demo by using
just one file. So it could be easily copied and paste.
So at the end, we should provide some explanation, mxml, screenshots and a
link to a working demo for each particular component.
I'll try to create an example tonight which could be used as template maybe.

Enjoy your vacation!

Thanks,
Olaf





--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63800.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[piotrz]

Hi Olaf,

Great idea!! 
As for the examples maybe it's worth to put them into FlexJS Tour where
Peter start initial work [1]. I will refresh it once I get back from
vacation. Anyone know whether we could take from Apache some new domain or
how to put it as subpage of our website? 

I will start slowly fill MDL part. Maybe put also things from binding, cause
I did couple of fixes there.

[1] https://github.com/apache/flex-tourjs/tree/develop

Piotr



-
Apache Flex PMC
piotrzarzyck...@gmail.com
--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63799.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Olaf Krueger]

Great input from all of you, thanks!
Unfortunately, I'm pretty sure that I don't know most of the FlexJS stuff
myself so expect some traffic here on the list related to all the topics
next time.

I'd like to create a demo (source code and live demo) for each particular
topic and I think it makes sense to add this demos also to the examples
folder of the asjs repo.
I remember that the compiled MDL examples are also available as JS/HTML live
demo anywhere.
How does this work?

>Another good topic is the fact that there’s a big difference between the
behavior of “visible” between old >Flex and FlexJS... You needed states and
includeIn to make components pop in and out.

If I understand you right I think in classic Flex you just can to set
includeInLayout to false?
I've just added it to the docs, would be great if you could verify what I've
written [1].

Please keep in mind that anybody of you could contribute to the wiki right
now.
Just click a topic and add or edit some content, it's pretty simple ;-)

Thanks,
Olaf

[1]
https://github.com/ok-at-github/flexjs-docs/wiki/Flex-vs-FlexJS-visibility-of-components



--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63798.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Harbs]

Data Binding needs special coverage because it requires some getting used to.

I’m not sure what the status of formatters and validators are. I think pretty 
weak at the moment.

We’re using the MDL dialog.

Another good topic is the fact that there’s a big difference between the 
behavior of “visible” between old Flex and FlexJS. In old Flex, visible still 
took up space. You needed states and includeIn to make components pop in and 
out. In FlexJS non-visible components take no space. This makes dynamic content 
much easier to declare.

> On Aug 9, 2017, at 6:51 PM, PKumar  wrote:
> 
> please add few pages  on following  topics. These are commonly  used in
> enterprise applications.
> 
> FlexJS Data  Binding
> Formatters - Date Formatter , Number  Formatter etc
> Validators - StringValidator, DateValidator etc
> Popupwindow or Dialog in FlexJS
> File Browse,  Upload and Download
> HTTPService
> 
> Thanks,
> Prashant
> 
> 
> 
> --
> View this message in context: 
> http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63789.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[PKumar]

please add few pages  on following  topics. These are commonly  used in
enterprise applications.

FlexJS Data  Binding
Formatters - Date Formatter , Number  Formatter etc
Validators - StringValidator, DateValidator etc
Popupwindow or Dialog in FlexJS
File Browse,  Upload and Download
HTTPService

Thanks,
Prashant



--
View this message in context: 
http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786p63789.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS][Docs] Started with some docs using a github repo

[Josh Tynjala]

I recommend including a review of basic MXML language features in the
getting started material. Things like binding, states, and even just how to
add children to containers, listen to events, and things like that. It's
good for people completely new to Flex/FlexJS, but I think it's also
important for experienced Flex developers. It shows them that FlexJS still
has many of the features that they liked, and puts them on familiar ground
before they need to jump into the differences in FlexJS, like PAYG and
beads.

- Josh

On Wed, Aug 9, 2017 at 4:13 AM, Olaf Krueger  wrote:

> Hi guys,
> it seems to me that since Adobe announced the EOL of FlashPlayer there's
> some more interest in FlexJS.
> And it also seems to me that is still not so easy to get in touch with
> FlexJS for others.
> One reason is probably the lack of the documentation.
>
> My feeling is that some more documentation is more important than ever at
> this time where folks probably think about which path they will go with
> their Flex apps in future.
>
> So I prioritized this task for myself and started a github wiki with the
> goal to fill the gap.
> I decide to go with github instead of our wiki cause I think it is easier
> to
> contribute for anybody who is willing to help.
> Moreover, the long term idea is to move to github pages to provide a shiny
> website dedicated to FlexJS.
> Bootstrap, Angular and others do impressive things using github pages with
> static site generators.
> If it turns out that this approach is helpful and if there are no technical
> issues it could be moved to Apache at any time of course.
>
> This is the link to the wiki [1].
> For now, it's just a scaffolding of what I would like to achieve at first.
> A
> lot of things are probably already available at other places but I think it
> is helpful to summarize all these things at one place.
>
> The repo is not restricted to some collaborators so anybody who's willing
> to
> help should be able to start right now.
>
> Thanks,
> Olaf
>
> [1] https://github.com/ok-at-github/flexjs-docs/wiki
>
>
>
>
> --
> View this message in context: http://apache-flex-
> development.247.n4.nabble.com/FlexJS-Docs-Started-with-
> some-docs-using-a-github-repo-tp63786.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.
>

Re: [FlexJS][Docs] Started with some docs using a github repo

[Harbs]

+1.

Here’s some topics that we need:

1. Different Layout beads and what they do.
2. What beads can be applied to which components
3. List of components and differences between them (i.e. Container vs Group)

There’s probably much more, but these come immediately to mind.

> On Aug 9, 2017, at 2:13 PM, Olaf Krueger  wrote:
> 
> Hi guys,
> it seems to me that since Adobe announced the EOL of FlashPlayer there's
> some more interest in FlexJS.
> And it also seems to me that is still not so easy to get in touch with
> FlexJS for others.
> One reason is probably the lack of the documentation.
> 
> My feeling is that some more documentation is more important than ever at
> this time where folks probably think about which path they will go with
> their Flex apps in future.
> 
> So I prioritized this task for myself and started a github wiki with the
> goal to fill the gap.
> I decide to go with github instead of our wiki cause I think it is easier to
> contribute for anybody who is willing to help.
> Moreover, the long term idea is to move to github pages to provide a shiny
> website dedicated to FlexJS.
> Bootstrap, Angular and others do impressive things using github pages with
> static site generators.
> If it turns out that this approach is helpful and if there are no technical
> issues it could be moved to Apache at any time of course.
> 
> This is the link to the wiki [1].
> For now, it's just a scaffolding of what I would like to achieve at first. A
> lot of things are probably already available at other places but I think it
> is helpful to summarize all these things at one place.
> 
> The repo is not restricted to some collaborators so anybody who's willing to
> help should be able to start right now.
> 
> Thanks,
> Olaf
> 
> [1] https://github.com/ok-at-github/flexjs-docs/wiki 
> 
> 
> 
> 
> --
> View this message in context: 
> http://apache-flex-development.247.n4.nabble.com/FlexJS-Docs-Started-with-some-docs-using-a-github-repo-tp63786.html
> Sent from the Apache Flex Development mailing list archive at Nabble.com.