Pharo Docs website broken

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 <[hidden email]> wrote:
>
>
>> On 11 Jan 2016, at 10:24, Dimitris Chloupis <[hidden email]> 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 <[hidden email]> 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 <[hidden email]> 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 <[hidden email]> 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."

Yes, that's what I talked about in the first place.

Here's the screenshot I should have included at first. See, no method names.

Also, if one tries resizing the panes, things start breaking in visually interesting ways…

On 11 Jan 2016, at 14:09, Nicolai Hess <[hidden email]> wrote:

2016-01-11 13:54 GMT+01:00 Esteban Lorenzano <[hidden email]>:

well, pharodocs look fine for me… but can be broken in other sources. 

What happens if you click on one link ?

For example, if I click on the

arrowDown method link, it scrolls to this text

"

Answer the Character representing a backspace.

Answer the class variable in which unique Characters are stored.

Just for ANSI Compliance

Added the rest of them!

Answer the Character representing a carriage return.

Answer the Character whose digit value is x. For example, answer $9 for x=9, $0 for x=0, $A for x=10, $Z for x=35.

Answer the Character representing enter.

Answer the ASCII ESC character

The Euro currency sign, that E with two dashes. The code point is a official unicode ISO/IEC-10646-1

Create the table of DigitsValues."

 

I will need to put an issue in my TODO :(

Esteban

<Screen Shot 2016-01-11 at 13.54.06.png>

On 11 Jan 2016, at 11:36, Dimitris Chloupis <[hidden email]> wrote:

All manual are being updated and I plan to also release static versions for each pharo release. We made great progress this year with the help of many contributors, we managed to port the entire PBE from latex to pillar and update many chapters to version 4, I have now started the porting to Pharo 5 and will be going through all chapters and updating them as needed and by the end of this year it should finish, from there on will be very easy to keep up with pharo releases.

On Mon, Jan 11, 2016 at 12:04 PM Ferlicot D. Cyril <[hidden email]> wrote:

Le 11/01/2016 10:37, Sven Van Caekenberghe a écrit :
>
> 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.
>

UPBE is not finish but it is usable. With a text that say to the user
that the content may evolve it should be fine.

>
>


--
Cyril Ferlicot

http://www.synectique.eu

165 Avenue Bretagne
Lille 59000 France