[Pharo-users] Pharo Docs website broken

stepharo stepharo at free.fr
Mon Jan 11 10:38:41 EST 2016


We should keep PBE and add another link.

Stef


Le 11/1/16 10:45, Tudor Girba a écrit :
> 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