[Pharo-users] Pharo Docs website broken

Tudor Girba tudor at tudorgirba.com
Mon Jan 11 04:45:01 EST 2016


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."





More information about the Pharo-users mailing list