You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@flex.apache.org by Christofer Dutz <ch...@c-ware.de> on 2016/09/27 15:04:35 UTC

[FlexJS] Maven generated site online

Hi guys,


today I finally managed to get the site generation and deployment working for the ASF infrastructure. The content produced now contains quite a lot of stuff and we could extend it to produce even more. Currently the most important parts are:

- documentation

- JavaDoc

- Test-Coverage reports


Ok ... I ran it without tests on my machine ... will re-run things on the ASF build agents as soon as they have one final thing resolved. Then we could be updating the content on that page on a daily basis automatically.


Please feel free to have a look: http://flex.apache.org/maven/flexjs/latest-dev/


Particularly interesting should be these pages here:

http://flex.apache.org/maven/flexjs/latest-dev/build.html

http://flex.apache.org/maven/flexjs/latest-dev/structure.html

Which are generated from the content in the flex-falcon/src/site/asciidoc directory using asciidoctor.


Chris

AW: [FlexJS] Maven generated site online

Posted by Christofer Dutz <ch...@c-ware.de>.
Hi Carlos,


the Flex/Actionscript part is currently missing from that because we don't have ASDoc working properly. If I extended the maven plugin to run asdoc for the framework part, we could start shipping that the same way the javadoc is shipped. That's also the reason I haven't started adding a site to the typedefs or the framework.


Chris

________________________________
Von: carlos.rovira@gmail.com <ca...@gmail.com> im Auftrag von Carlos Rovira <ca...@codeoscopic.com>
Gesendet: Mittwoch, 28. September 2016 19:25:05
An: dev@flex.apache.org
Betreff: Re: [FlexJS] Maven generated site online

Hi Chris,

I checking the generated site, and can't see nothing related to asjs. Could
I expect to see the flexjs components API there?

btw,  in other thread I ask you for a simple pom. I can't make it work for
a simple project and would need one simple example to start. One not living
in examples, and that output on target (like you suggest), hope you could
share one.

thanks



2016-09-27 18:01 GMT+02:00 Carlos Rovira <ca...@codeoscopic.com>:

> Hi Chris, this is pretty amazing! a looks so good! :))
>
> Congrats to get it up and running! :)
>
> 2016-09-27 17:04 GMT+02:00 Christofer Dutz <ch...@c-ware.de>:
>
>> Hi guys,
>>
>>
>> today I finally managed to get the site generation and deployment working
>> for the ASF infrastructure. The content produced now contains quite a lot
>> of stuff and we could extend it to produce even more. Currently the most
>> important parts are:
>>
>> - documentation
>>
>> - JavaDoc
>>
>> - Test-Coverage reports
>>
>>
>> Ok ... I ran it without tests on my machine ... will re-run things on the
>> ASF build agents as soon as they have one final thing resolved. Then we
>> could be updating the content on that page on a daily basis automatically.
>>
>>
>> Please feel free to have a look: http://flex.apache.org/maven/f
>> lexjs/latest-dev/
>>
>>
>> Particularly interesting should be these pages here:
>>
>> http://flex.apache.org/maven/flexjs/latest-dev/build.html
>>
>> http://flex.apache.org/maven/flexjs/latest-dev/structure.html
>>
>> Which are generated from the content in the flex-falcon/src/site/asciidoc
>> directory using asciidoctor.
>>
>>
>> Chris
>>
>
>
>
> --
>
> Carlos Rovira
> Director General
> M: +34 607 22 60 05
> http://www.codeoscopic.com
> http://www.avant2.es
>
>
> Este mensaje se dirige exclusivamente a su destinatario y puede contener
> información privilegiada o confidencial. Si ha recibido este mensaje por
> error, le rogamos que nos lo comunique inmediatamente por esta misma vía y
> proceda a su destrucción.
>
> De la vigente Ley Orgánica de Protección de Datos (15/1999), le
> comunicamos que sus datos forman parte de un fichero cuyo responsable es
> CODEOSCOPIC S.A. La finalidad de dicho tratamiento es facilitar la
> prestación del servicio o información solicitados, teniendo usted derecho
> de acceso, rectificación, cancelación y oposición de sus datos dirigiéndose
> a nuestras oficinas c/ Paseo de la Habana 9-11, 28036, Madrid con la
> documentación necesaria.
>
>


--

Carlos Rovira
Director General
M: +34 607 22 60 05
http://www.codeoscopic.com
http://www.avant2.es


Este mensaje se dirige exclusivamente a su destinatario y puede contener
información privilegiada o confidencial. Si ha recibido este mensaje por
error, le rogamos que nos lo comunique inmediatamente por esta misma vía y
proceda a su destrucción.

De la vigente Ley Orgánica de Protección de Datos (15/1999), le comunicamos
que sus datos forman parte de un fichero cuyo responsable es CODEOSCOPIC
S.A. La finalidad de dicho tratamiento es facilitar la prestación del
servicio o información solicitados, teniendo usted derecho de acceso,
rectificación, cancelación y oposición de sus datos dirigiéndose a nuestras
oficinas c/ Paseo de la Habana 9-11, 28036, Madrid con la documentación
necesaria.

Re: [FlexJS] Maven generated site online

Posted by Carlos Rovira <ca...@codeoscopic.com>.
Hi Chris,

I checking the generated site, and can't see nothing related to asjs. Could
I expect to see the flexjs components API there?

btw,  in other thread I ask you for a simple pom. I can't make it work for
a simple project and would need one simple example to start. One not living
in examples, and that output on target (like you suggest), hope you could
share one.

thanks



2016-09-27 18:01 GMT+02:00 Carlos Rovira <ca...@codeoscopic.com>:

> Hi Chris, this is pretty amazing! a looks so good! :))
>
> Congrats to get it up and running! :)
>
> 2016-09-27 17:04 GMT+02:00 Christofer Dutz <ch...@c-ware.de>:
>
>> Hi guys,
>>
>>
>> today I finally managed to get the site generation and deployment working
>> for the ASF infrastructure. The content produced now contains quite a lot
>> of stuff and we could extend it to produce even more. Currently the most
>> important parts are:
>>
>> - documentation
>>
>> - JavaDoc
>>
>> - Test-Coverage reports
>>
>>
>> Ok ... I ran it without tests on my machine ... will re-run things on the
>> ASF build agents as soon as they have one final thing resolved. Then we
>> could be updating the content on that page on a daily basis automatically.
>>
>>
>> Please feel free to have a look: http://flex.apache.org/maven/f
>> lexjs/latest-dev/
>>
>>
>> Particularly interesting should be these pages here:
>>
>> http://flex.apache.org/maven/flexjs/latest-dev/build.html
>>
>> http://flex.apache.org/maven/flexjs/latest-dev/structure.html
>>
>> Which are generated from the content in the flex-falcon/src/site/asciidoc
>> directory using asciidoctor.
>>
>>
>> Chris
>>
>
>
>
> --
>
> Carlos Rovira
> Director General
> M: +34 607 22 60 05
> http://www.codeoscopic.com
> http://www.avant2.es
>
>
> Este mensaje se dirige exclusivamente a su destinatario y puede contener
> información privilegiada o confidencial. Si ha recibido este mensaje por
> error, le rogamos que nos lo comunique inmediatamente por esta misma vía y
> proceda a su destrucción.
>
> De la vigente Ley Orgánica de Protección de Datos (15/1999), le
> comunicamos que sus datos forman parte de un fichero cuyo responsable es
> CODEOSCOPIC S.A. La finalidad de dicho tratamiento es facilitar la
> prestación del servicio o información solicitados, teniendo usted derecho
> de acceso, rectificación, cancelación y oposición de sus datos dirigiéndose
> a nuestras oficinas c/ Paseo de la Habana 9-11, 28036, Madrid con la
> documentación necesaria.
>
>


-- 

Carlos Rovira
Director General
M: +34 607 22 60 05
http://www.codeoscopic.com
http://www.avant2.es


Este mensaje se dirige exclusivamente a su destinatario y puede contener
información privilegiada o confidencial. Si ha recibido este mensaje por
error, le rogamos que nos lo comunique inmediatamente por esta misma vía y
proceda a su destrucción.

De la vigente Ley Orgánica de Protección de Datos (15/1999), le comunicamos
que sus datos forman parte de un fichero cuyo responsable es CODEOSCOPIC
S.A. La finalidad de dicho tratamiento es facilitar la prestación del
servicio o información solicitados, teniendo usted derecho de acceso,
rectificación, cancelación y oposición de sus datos dirigiéndose a nuestras
oficinas c/ Paseo de la Habana 9-11, 28036, Madrid con la documentación
necesaria.

Re: [FlexJS] Maven generated site online

Posted by Carlos Rovira <ca...@codeoscopic.com>.
Hi Chris, this is pretty amazing! a looks so good! :))

Congrats to get it up and running! :)

2016-09-27 17:04 GMT+02:00 Christofer Dutz <ch...@c-ware.de>:

> Hi guys,
>
>
> today I finally managed to get the site generation and deployment working
> for the ASF infrastructure. The content produced now contains quite a lot
> of stuff and we could extend it to produce even more. Currently the most
> important parts are:
>
> - documentation
>
> - JavaDoc
>
> - Test-Coverage reports
>
>
> Ok ... I ran it without tests on my machine ... will re-run things on the
> ASF build agents as soon as they have one final thing resolved. Then we
> could be updating the content on that page on a daily basis automatically.
>
>
> Please feel free to have a look: http://flex.apache.org/maven/
> flexjs/latest-dev/
>
>
> Particularly interesting should be these pages here:
>
> http://flex.apache.org/maven/flexjs/latest-dev/build.html
>
> http://flex.apache.org/maven/flexjs/latest-dev/structure.html
>
> Which are generated from the content in the flex-falcon/src/site/asciidoc
> directory using asciidoctor.
>
>
> Chris
>



-- 

Carlos Rovira
Director General
M: +34 607 22 60 05
http://www.codeoscopic.com
http://www.avant2.es


Este mensaje se dirige exclusivamente a su destinatario y puede contener
información privilegiada o confidencial. Si ha recibido este mensaje por
error, le rogamos que nos lo comunique inmediatamente por esta misma vía y
proceda a su destrucción.

De la vigente Ley Orgánica de Protección de Datos (15/1999), le comunicamos
que sus datos forman parte de un fichero cuyo responsable es CODEOSCOPIC
S.A. La finalidad de dicho tratamiento es facilitar la prestación del
servicio o información solicitados, teniendo usted derecho de acceso,
rectificación, cancelación y oposición de sus datos dirigiéndose a nuestras
oficinas c/ Paseo de la Habana 9-11, 28036, Madrid con la documentación
necesaria.

AW: [FlexJS] Maven generated site online

Posted by Christofer Dutz <ch...@c-ware.de>.
Hi Olaf,


well I think that some things belong in the Wiki and some in the Site. The wiki is definitely ideal for Howtos and stuff like that. The Site seems the better place for documentation on how to:

- Build

- Branch

- Test

- Use

- ...


What I'm going to do, is start writing my content on building FlexJS with Maven, Creating own Projects with FlexJS and Maven, using the ASF Infrastructure etc in the Site.


We can always decide to move it somewhere else or move in more content later.


Chris

________________________________
Von: OK <po...@olafkrueger.net>
Gesendet: Donnerstag, 29. September 2016 09:25:24
An: dev@flex.apache.org
Betreff: Re: [FlexJS] Maven generated site online

Looks promising!
Do you think it should reside parallel to the wiki or should it replace the
wiki one day?
Seems to me that is not so easy to find a consensus that makes everyone
happy... ;-)

Thanks,
Olaf



--
View this message in context: http://apache-flex-development.2333347.n4.nabble.com/FlexJS-Maven-generated-site-online-tp55356p55442.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.

Re: [FlexJS] Maven generated site online

Posted by OK <po...@olafkrueger.net>.
Looks promising!
Do you think it should reside parallel to the wiki or should it replace the
wiki one day?
Seems to me that is not so easy to find a consensus that makes everyone
happy... ;-)

Thanks,
Olaf



--
View this message in context: http://apache-flex-development.2333347.n4.nabble.com/FlexJS-Maven-generated-site-online-tp55356p55442.html
Sent from the Apache Flex Development mailing list archive at Nabble.com.