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>