[Pharo-users] Pharo Docs website broken

Sven Van Caekenberghe sven at stfx.eu
Mon Jan 11 04:37:23 EST 2016


> On 11 Jan 2016, at 10:24, Dimitris Chloupis <kilon.alios at gmail.com> wrote:
> 
> I agree with you only 100% + 1. 
> 
> Also note that UPBE is not promoted even though its the most begineer friendly documentation we have, instead you have to navigate through the links to get there. 

There is books.pharo.org

PBE is there, I thought UPBE was not yet ready, if it is, it should **definitively** be promoted there and on pharo.org in general.

Please push this, this is really important.

> AFAIK the documentation page could use some love, promoting our main Book, UPBE, Pharo for the Enterprise , Deep Into Pharo. Those 3 are essential reading for anyone coming to pharo and they are in a pretty good state , though WIP. 
> 
> I have to say that I never liked Pharo docs because it shows how few classes contain comments and it definitely does not look good for someone looking to enter pharo. 
> 
> On Mon, Jan 11, 2016 at 1:48 AM David Allouche <david at allouche.net> wrote:
> I could argue about how I agree with you, but only in part.
> 
> But the simple fact is this: the documentation is advertised in large letter on this page: http://pharo.org/documentation
> 
> If it's broken, it should be fixed. If the people with the technical access to fix it do not care, it should be removed from such a highly visible page.
> 
> As it is, it is confusing for new users, who need it most, and reflects badly on the state of Pharo in general.
> 
> > On 10 Jan 2016, at 22:25, Serge Stinckwich <serge.stinckwich at gmail.com> wrote:
> >
> > Dear David,
> >
> > yes this maybe broken, but most of the time, a Pharo developer will
> > never have a look to such a static documentation.
> > You can browse the class and the related methods very easily inside
> > the Pharo image, without relying on an external tool.
> >
> > Regards,
> >
> > On Sun, Jan 10, 2016 at 1:08 PM, David Allouche <david at allouche.net> wrote:
> >> Hello,
> >>
> >> It seems the pharodocs website is broken. Pages for classes are rendered,
> >> but the documentation does not display the messages, only their docstrings.
> >> That makes it quite unusable.
> >>
> >> http://files.pharo.org/doc/4.0/#packageList=package.html&classList=package/Kernel.html&classView=class/ProtoObject.html
> >>
> >> I remember I looked at it once when I started and thought "whee, that's
> >> confusing, I'll play around and come back later". Now I understand why that
> >> was confusing...
> >>
> >> Who can fix that?
> >
> >
> >
> > --
> > Serge Stinckwich
> > UCBN & UMI UMMISCO 209 (IRD/UPMC)
> > Every DSL ends up being Smalltalk
> > http://www.doesnotunderstand.org/
> >
> 
> 





More information about the Pharo-users mailing list