[Pharo-users] Pharo Docs website broken

Nicolai Hess nicolaihess at gmail.com
Mon Jan 11 04:40:52 EST 2016


I opened a fogbugz issue
17348
<https://pharo.fogbugz.com/f/cases/17348/Enhance-shortcut-learnability>
remove pharo documentation link

2016-01-11 2:37 GMT+01:00 John Pfersich <jpfersich at gmail.com>:

> On my iPad the docs look like this:
>
>
>
> It's an unusable mess.
>
> Sent from my iPad
>
> > On Jan 10, 2016, at 15:47, 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/a91064f8/attachment.html>


More information about the Pharo-users mailing list