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