[Pharo-users] Pharo Docs website broken

Dimitris Chloupis kilon.alios at gmail.com
Mon Jan 11 04:50:51 EST 2016


Done

https://pharo.fogbugz.com/f/cases/17371/No-direct-link-to-the-UPBE-pdf

On Mon, Jan 11, 2016 at 11:45 AM Tudor Girba <tudor at tudorgirba.com> wrote:

> I think that UPBE is in definitely a better state than PBE. We should
> switch the link.
>
> @Dimitris: Could you open an issue for this?
>
> Doru
>
>
> > On Jan 11, 2016, at 11:37 AM, Sven Van Caekenberghe <sven at stfx.eu>
> wrote:
> >
> >
> >> 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/
> >>>
> >>
> >>
> >
> >
>
> --
> www.tudorgirba.com
> www.feenk.com
>
> "To utilize feedback, you first have to acquire it."
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pharo.org/pipermail/pharo-users_lists.pharo.org/attachments/20160111/83d4353f/attachment.html>


More information about the Pharo-users mailing list