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@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@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@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@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/K...
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/