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> 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=development,VM=vm/585/artifact/doc/index.html#packageList=package.html&classList=package/ConfigurationOfWebDoc.html&classView=welcome.html
> [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc