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 <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."