2015-04-24 9:18 GMT+02:00 Max Leske <maxleske@gmail.com>:
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.
+1 Fully agree. Luc
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=developme... [3]http://www.smalltalkhub.com/#!/~PharoExtras/WebDoc