Done https://pharo.fogbugz.com/f/cases/17371/No-direct-link-to-the-UPBE-pdf
On Mon, Jan 11, 2016 at 11:45 AM Tudor Girba <tu...@tudorgirba.com> wrote: > 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." > > >
