- Pharo-users - lists.pharo.org

Re: [Pharo-users] Pharo Docs website broken

by Ferlicot D. Cyril

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

Jan. 11, 2016

PharoLauncher MUST BE the default download of Pharo

by Dimitris Chloupis

Talking about pharo being begineer friendly , PharoLauncher must be the default download for pharo. This is something that I have been promoting for past 2 year and Esteban informed he has been promoting this idea before me. So for those people that believe that pharo is begineer friendly.... prove it.

Jan. 11, 2016

Re: [Pharo-users] Pharo Docs website broken

by Dimitris Chloupis

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 <tudor(a)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 <sven(a)stfx.eu> > wrote: > > > > > >> On 11 Jan 2016, at 10:24, Dimitris Chloupis <kilon.alios(a)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(a)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(a)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(a)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/… > >>>> > >>>> 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." > > >

Jan. 11, 2016

happy lessons from recent talks

by Tudor Girba

Hi, I just wanted to share with you a bit of a different perspective on what we do around here. Over the past half a year I gave several talks to some 1k technical people at industrial events like ArchConf, NDC Oslo and several others. The tour will continue this year at OOP, ArchConf and a couple of other places. These are places where people talk about mainstream techniques & technologies (like Java, JS, C#). For example, ArchConf is a premier software architecture conference in the US. During these sessions, people get to experience Moose and Pharo through live demos. I use these demos as examples of how humane assessment (building your own analysis tools) can boost engineering decisions making in practice. I consistently receive the feedback that the live programming possibilities from Pharo/Moose are impressive. But, more recently, there is something else worthy of being noted. If in previous years, nobody heard about what we do, this year I started to get consistently a couple of persons in the room that have heard something about Pharo/Moose before the presentation. This is huge. While a couple might not sound like much, you should remember that information (especially in this technical space) has the capability of spreading exponentially. What we have done over the past years starts to show results. We have to keep it up. Happy New Year! Cheers, Doru -- www.tudorgirba.com www.feenk.com "Problem solving should be focused on describing the problem in a way that makes the solution obvious."

Jan. 11, 2016

Re: [Pharo-users] Pharo Docs website broken

by Tudor Girba

Thanks. Doru > On Jan 11, 2016, at 11:40 AM, Nicolai Hess <nicolaihess(a)gmail.com> wrote: > > I opened a fogbugz issue > 17348 remove pharo documentation link > > 2016-01-11 2:37 GMT+01:00 John Pfersich <jpfersich(a)gmail.com>: > On my iPad the docs look like this: > > > > It's an unusable mess. > > Sent from my iPad > > > On Jan 10, 2016, at 15:47, David Allouche <david(a)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(a)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(a)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/… > >>> > >>> 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 "Yesterday is a fact. Tomorrow is a possibility. Today is a challenge."

Jan. 11, 2016

Re: [Pharo-users] Pharo Docs website broken

by Tudor Girba

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

Jan. 11, 2016

Re: [Pharo-users] Pharo Docs website broken

by Nicolai Hess

I opened a fogbugz issue 17348 <https://pharo.fogbugz.com/f/cases/17348/Enhance-shortcut-learnability> remove pharo documentation link 2016-01-11 2:37 GMT+01:00 John Pfersich <jpfersich(a)gmail.com>: > On my iPad the docs look like this: > > > > It's an unusable mess. > > Sent from my iPad > > > On Jan 10, 2016, at 15:47, David Allouche <david(a)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(a)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(a)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/… > >>> > >>> 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/ > > > > > >

Jan. 11, 2016

Re: [Pharo-users] Pharo Docs website broken

by Sven Van Caekenberghe

> On 11 Jan 2016, at 10:24, Dimitris Chloupis <kilon.alios(a)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(a)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(a)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(a)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/… > >> > >> 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/ > > > >

Jan. 11, 2016

Re: [Pharo-users] Pharo Docs website broken

by Dimitris Chloupis

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. 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(a)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(a)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(a)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/… > >> > >> 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/ > > > > >

Jan. 11, 2016

Re: [Pharo-users] Pharo Docs website broken

by John Pfersich

On my iPad the docs look like this: It's an unusable mess. Sent from my iPad > On Jan 10, 2016, at 15:47, David Allouche <david(a)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(a)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(a)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/… >>> >>> 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/ > >

Jan. 11, 2016