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@stfx.eu> wrote:
>
>
>> On 11 Jan 2016, at 10:24, Dimitris Chloupis <kilon.alios@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@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/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."