[Pharo-users] Pharo Docs website broken

Dimitris Chloupis kilon.alios at gmail.com
Mon Jan 11 04:24:38 EST 2016


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.

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/
> >
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pharo.org/pipermail/pharo-users_lists.pharo.org/attachments/20160111/dd27c611/attachment.html>


More information about the Pharo-users mailing list