Quick answer, no. More elaborate one: The exports of the full pharo release (versions 3.0 and 4.0) exist and were created by Esteban manually before each release. These, are hosted here http://file-pharo.inria.fr/doc/4.0 http://file-pharo.inria.fr/doc/3.0 We could run it automatically every day with latest pharo to avoid the manual steps. I'll add that into my todo and check it later ^^. El jue., 23 de abr. de 2015 a la(s) 4:09 p. m., Sven Van Caekenberghe < sven@stfx.eu> escribió:

Great! Thank you.

And the full image export, is that somewhere (done automatically) ?

...

On 23 Apr 2015, at 15:56, Guillermo Polito <guillermopolito@gmail.com> wrote:

Hi guys,

I started yesterday to update WebDoc to work on latest Pharo. I share with you my progress since yesterday:

- Now it loads in latest pharo4 :) - fixed javascript errors and render issues - a little of love to the css styles - removed unused/not working features - made it work well when exporting not the full image - ci job is again green [1]

you can see the result of applying webdoc to webdoc as the result of the ci job here [2]. If you use it further, you'll see there are still of course some problems, but I feel it is better than before :).

If you want to check it out, instructions in [3]. Download:

Gofer it smalltalkhubUser: 'PharoExtras' project: 'WebDoc'; package:'ConfigurationOfWebDoc'; load.

(#ConfigurationOfWebDoc asClass project version: #development) load.

Export: (WebDocExporter packages: {RPackageOrganizer default packageNamed: 'YourProject'}) title: 'YourProject'; exportTo: './doc' asFileReference.

Guille

[1] https://ci.inria.fr/pharo-contribution/job/WebDoc/ [2] https://ci.inria.fr/pharo-contribution/job/WebDoc/PHARO=40,VERSION=developme... [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc

Is it used? Is it useful? I tried to browse a method during 5 min and the result was really strange May be my browser is broken (safari) Le 23/4/15 17:15, Guillermo Polito a écrit :

Quick answer, no.

More elaborate one:

The exports of the full pharo release (versions 3.0 and 4.0) exist and were created by Esteban manually before each release. These, are hosted here

http://file-pharo.inria.fr/doc/4.0 http://file-pharo.inria.fr/doc/3.0

We could run it automatically every day with latest pharo to avoid the manual steps. I'll add that into my todo and check it later ^^.

El jue., 23 de abr. de 2015 a la(s) 4:09 p. m., Sven Van Caekenberghe <sven@stfx.eu <mailto:sven@stfx.eu>> escribió:

Great! Thank you.

And the full image export, is that somewhere (done automatically) ?

> On 23 Apr 2015, at 15:56, Guillermo Polito <guillermopolito@gmail.com <mailto:guillermopolito@gmail.com>> wrote: > > Hi guys, > > I started yesterday to update WebDoc to work on latest Pharo. I share with you my progress since yesterday: > > - Now it loads in latest pharo4 :) > - fixed javascript errors and render issues > - a little of love to the css styles > - removed unused/not working features > - made it work well when exporting not the full image > - ci job is again green [1] > > you can see the result of applying webdoc to webdoc as the result of the ci job here [2]. If you use it further, you'll see there are still of course some problems, but I feel it is better than before :). > > If you want to check it out, instructions in [3]. > Download: > > Gofer it > smalltalkhubUser: 'PharoExtras' project: 'WebDoc'; > package:'ConfigurationOfWebDoc'; > load. > > (#ConfigurationOfWebDoc asClass project version: #development) load. > > Export: > (WebDocExporter packages: {RPackageOrganizer default packageNamed: 'YourProject'}) > title: 'YourProject'; > exportTo: './doc' asFileReference. > > > Guille > > [1] https://ci.inria.fr/pharo-contribution/job/WebDoc/ > [2] https://ci.inria.fr/pharo-contribution/job/WebDoc/PHARO=40,VERSION=developme... > [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc <http://www.smalltalkhub.com/#%21/%7EPharoExtras/WebDoc>

Ok I saw with the version 30 it is much better :) Because I was surprised that someone could do anything with the 40. Now in that case we should not just put in it in the obscure file server but promoted to the website. Stef Le 24/4/15 09:41, Esteban Lorenzano a écrit :

no, docs for pharo 4.0 are broken. I will regenerate it next week (it takes hours).

and about if it is useful: no experienced smalltalker will ever use it. But newbies and google indexer will.

So is good to have it and not much effort, I think.

Esteban

...

On 24 Apr 2015, at 08:37, stepharo <stepharo@free.fr <mailto:stepharo@free.fr>> wrote:

Is it used? Is it useful? I tried to browse a method during 5 min and the result was really strange May be my browser is broken (safari)

<jcdfgjeg..png> Le 23/4/15 17:15, Guillermo Polito a écrit :<cbeahccf..png>

...

Quick answer, no.

More elaborate one:

The exports of the full pharo release (versions 3.0 and 4.0) exist and were created by Esteban manually before each release. These, are hosted here

http://file-pharo.inria.fr/doc/4.0 http://file-pharo.inria.fr/doc/3.0

We could run it automatically every day with latest pharo to avoid the manual steps. I'll add that into my todo and check it later ^^.

El jue., 23 de abr. de 2015 a la(s) 4:09 p. m., Sven Van Caekenberghe <sven@stfx.eu <mailto:sven@stfx.eu>> escribió:

Great! Thank you.

And the full image export, is that somewhere (done automatically) ?

> On 23 Apr 2015, at 15:56, Guillermo Polito <guillermopolito@gmail.com <mailto:guillermopolito@gmail.com>> wrote: > > Hi guys, > > I started yesterday to update WebDoc to work on latest Pharo. I share with you my progress since yesterday: > > - Now it loads in latest pharo4 :) > - fixed javascript errors and render issues > - a little of love to the css styles > - removed unused/not working features > - made it work well when exporting not the full image > - ci job is again green [1] > > you can see the result of applying webdoc to webdoc as the result of the ci job here [2]. If you use it further, you'll see there are still of course some problems, but I feel it is better than before :). > > If you want to check it out, instructions in [3]. > Download: > > Gofer it > smalltalkhubUser: 'PharoExtras' project: 'WebDoc'; > package:'ConfigurationOfWebDoc'; > load. > > (#ConfigurationOfWebDoc asClass project version: #development) load. > > Export: > (WebDocExporter packages: {RPackageOrganizer default packageNamed: 'YourProject'}) > title: 'YourProject'; > exportTo: './doc' asFileReference. > > > Guille > > [1] https://ci.inria.fr/pharo-contribution/job/WebDoc/ > [2] https://ci.inria.fr/pharo-contribution/job/WebDoc/PHARO=40,VERSION=developme... > [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc <http://www.smalltalkhub.com/#%21/%7EPharoExtras/WebDoc>

On Fri, Apr 24, 2015 at 9:06 AM, Esteban Lorenzano <estebanlm@gmail.com> wrote:

On 24 Apr 2015, at 08:56, stepharo <stepharo@free.fr> wrote:

Ok I saw with the version 30 it is much better :) Because I was surprised that someone could do anything with the 40. Now in that case we should not just put in it in the obscure file server but promoted to the website.

it is: http://pharo.org/documentation

Search through pharodocs <http://files.pharo.org/doc/4.0>

The reference website for documentation about Pharo.

Where is the 3.0 version? This is a 4.0 with the popping up hierarchy that makes it unusable as the popup obscures the description of the class. Phil

Esteban

Stef

Le 24/4/15 09:41, Esteban Lorenzano a écrit :

no, docs for pharo 4.0 are broken. I will regenerate it next week (it takes hours).

and about if it is useful: no experienced smalltalker will ever use it. But newbies and google indexer will.

So is good to have it and not much effort, I think.

Esteban

On 24 Apr 2015, at 08:37, stepharo <stepharo@free.fr> wrote:

Is it used? Is it useful? I tried to browse a method during 5 min and the result was really strange May be my browser is broken (safari)

<jcdfgjeg..png> Le 23/4/15 17:15, Guillermo Polito a écrit :<cbeahccf..png>

Quick answer, no.

More elaborate one:

The exports of the full pharo release (versions 3.0 and 4.0) exist and were created by Esteban manually before each release. These, are hosted here

http://file-pharo.inria.fr/doc/4.0 http://file-pharo.inria.fr/doc/3.0

We could run it automatically every day with latest pharo to avoid the manual steps. I'll add that into my todo and check it later ^^.

El jue., 23 de abr. de 2015 a la(s) 4:09 p. m., Sven Van Caekenberghe < sven@stfx.eu> escribió:

...

Great! Thank you.

And the full image export, is that somewhere (done automatically) ?

...

On 23 Apr 2015, at 15:56, Guillermo Polito <guillermopolito@gmail.com> wrote:

Hi guys,

I started yesterday to update WebDoc to work on latest Pharo. I share with you my progress since yesterday:

- Now it loads in latest pharo4 :) - fixed javascript errors and render issues - a little of love to the css styles - removed unused/not working features - made it work well when exporting not the full image - ci job is again green [1]

you can see the result of applying webdoc to webdoc as the result of the ci job here [2]. If you use it further, you'll see there are still of course some problems, but I feel it is better than before :).

If you want to check it out, instructions in [3]. Download:

Gofer it smalltalkhubUser: 'PharoExtras' project: 'WebDoc'; package:'ConfigurationOfWebDoc'; load.

(#ConfigurationOfWebDoc asClass project version: #development) load.

Export: (WebDocExporter packages: {RPackageOrganizer default packageNamed: 'YourProject'}) title: 'YourProject'; exportTo: './doc' asFileReference.

Guille

[1] https://ci.inria.fr/pharo-contribution/job/WebDoc/ [2] https://ci.inria.fr/pharo-contribution/job/WebDoc/PHARO=40,VERSION=developme... [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc

On Fri, Apr 24, 2015 at 8:56 AM, stepharo <stepharo@free.fr> wrote:

Ok I saw with the version 30 it is much better :) Because I was surprised that someone could do anything with the 40. Now in that case we should not just put in it in the obscure file server but promoted to the website.

Stef

Le 24/4/15 09:41, Esteban Lorenzano a écrit :

no, docs for pharo 4.0 are broken. I will regenerate it next week (it takes hours).

and about if it is useful: no experienced smalltalker will ever use it. But newbies and google indexer will.

We'd be having package level comments, that would be another story. Thus we'd be closer to JavaDoc (e.g. https://jaxb.java.net/nonav/2.2.1/docs/api/index.html?overview-summary.html) It is also useful to look into things without having to load them in. Phil

So is good to have it and not much effort, I think.

Esteban

On 24 Apr 2015, at 08:37, stepharo <stepharo@free.fr> wrote:

Is it used? Is it useful? I tried to browse a method during 5 min and the result was really strange May be my browser is broken (safari)

<jcdfgjeg..png> Le 23/4/15 17:15, Guillermo Polito a écrit :<cbeahccf..png>

Quick answer, no.

More elaborate one:

The exports of the full pharo release (versions 3.0 and 4.0) exist and were created by Esteban manually before each release. These, are hosted here

http://file-pharo.inria.fr/doc/4.0 http://file-pharo.inria.fr/doc/3.0

We could run it automatically every day with latest pharo to avoid the manual steps. I'll add that into my todo and check it later ^^.

El jue., 23 de abr. de 2015 a la(s) 4:09 p. m., Sven Van Caekenberghe < sven@stfx.eu> escribió:

...

Great! Thank you.

And the full image export, is that somewhere (done automatically) ?

...

On 23 Apr 2015, at 15:56, Guillermo Polito <guillermopolito@gmail.com> wrote:

Hi guys,

I started yesterday to update WebDoc to work on latest Pharo. I share with you my progress since yesterday:

- Now it loads in latest pharo4 :) - fixed javascript errors and render issues - a little of love to the css styles - removed unused/not working features - made it work well when exporting not the full image - ci job is again green [1]

you can see the result of applying webdoc to webdoc as the result of the ci job here [2]. If you use it further, you'll see there are still of course some problems, but I feel it is better than before :).

If you want to check it out, instructions in [3]. Download:

Gofer it smalltalkhubUser: 'PharoExtras' project: 'WebDoc'; package:'ConfigurationOfWebDoc'; load.

(#ConfigurationOfWebDoc asClass project version: #development) load.

Export: (WebDocExporter packages: {RPackageOrganizer default packageNamed: 'YourProject'}) title: 'YourProject'; exportTo: './doc' asFileReference.

Guille

[1] https://ci.inria.fr/pharo-contribution/job/WebDoc/ [2] https://ci.inria.fr/pharo-contribution/job/WebDoc/PHARO=40,VERSION=developme... [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc

Le 24 avr. 2015 à 13:15, Sean P. DeNigris a écrit :

philippeback wrote

...

We'd be having package level comments, that would be another story.

Now that we have real package objects, is there anything that prevents it? I also wanted this for a loooong time...

We can already add a description in the PackageManifest but the tooling support is missing.

On 24 Apr 2015, at 08:41, Esteban Lorenzano <estebanlm@gmail.com> wrote:

no, docs for pharo 4.0 are broken. I will regenerate it next week (it takes hours).

and about if it is useful: no experienced smalltalker will ever use it. But newbies and google indexer will.

When I took Oscar's programming language class and we used Pharo, that was one of the first questions: is there a doc? My reaction at first was to tell them to look at the source code. But it takes a while to getting used to that idea. If you come from other languages you just expect a doc. And if there isn’t one “then something must be wrong with that Pharo language” is the common reaction. So yes, as Esteban says, we need it for promotional purposes.

So is good to have it and not much effort, I think.

Esteban

...

On 24 Apr 2015, at 08:37, stepharo <stepharo@free.fr <mailto:stepharo@free.fr>> wrote:

Is it used? Is it useful? I tried to browse a method during 5 min and the result was really strange May be my browser is broken (safari)

<jcdfgjeg..png> Le 23/4/15 17:15, Guillermo Polito a écrit :<cbeahccf..png>

...

Quick answer, no.

More elaborate one:

The exports of the full pharo release (versions 3.0 and 4.0) exist and were created by Esteban manually before each release. These, are hosted here

http://file-pharo.inria.fr/doc/4.0 <http://file-pharo.inria.fr/doc/4.0> http://file-pharo.inria.fr/doc/3.0 <http://file-pharo.inria.fr/doc/3.0>

We could run it automatically every day with latest pharo to avoid the manual steps. I'll add that into my todo and check it later ^^.

El jue., 23 de abr. de 2015 a la(s) 4:09 p. m., Sven Van Caekenberghe <sven@stfx.eu <mailto:sven@stfx.eu>> escribió: Great! Thank you.

And the full image export, is that somewhere (done automatically) ?

...

On 23 Apr 2015, at 15:56, Guillermo Polito <guillermopolito@gmail.com <mailto:guillermopolito@gmail.com>> wrote:

Hi guys,

I started yesterday to update WebDoc to work on latest Pharo. I share with you my progress since yesterday:

- Now it loads in latest pharo4 :) - fixed javascript errors and render issues - a little of love to the css styles - removed unused/not working features - made it work well when exporting not the full image - ci job is again green [1]

you can see the result of applying webdoc to webdoc as the result of the ci job here [2]. If you use it further, you'll see there are still of course some problems, but I feel it is better than before :).

If you want to check it out, instructions in [3]. Download:

Gofer it smalltalkhubUser: 'PharoExtras' project: 'WebDoc'; package:'ConfigurationOfWebDoc'; load.

(#ConfigurationOfWebDoc asClass project version: #development) load.

Export: (WebDocExporter packages: {RPackageOrganizer default packageNamed: 'YourProject'}) title: 'YourProject'; exportTo: './doc' asFileReference.

Guille

[1] https://ci.inria.fr/pharo-contribution/job/WebDoc/ <https://ci.inria.fr/pharo-contribution/job/WebDoc/> [2] https://ci.inria.fr/pharo-contribution/job/WebDoc/PHARO=40,VERSION=developme... <https://ci.inria.fr/pharo-contribution/job/WebDoc/PHARO=40,VERSION=developme...> [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc <http://www.smalltalkhub.com/#%21/%7EPharoExtras/WebDoc>