Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread stepharo
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 wrote: On

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Dimitris Chloupis
Personally I would prefer if Esteban kept working on documenting the new FFI. Thats a top priority doc wise, the rest can wait. Στις Δευ, 11 Ιαν 2016 - 15:57 ο χρήστης Johan Fabry έγραψε: > > I better understand the reason for existence of pharodocs, thanks! I also > understand that you want to

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Johan Fabry
I better understand the reason for existence of pharodocs, thanks! I also understand that you want to keep it. BUT: please keep in mind that having bad documentation is actually worse than not having any documentation at all. So ideally you would regenerate the site tonight before you go to sl

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Dimitris Chloupis
I was wondering if github interface could help here to make it much more powerful On Mon, Jan 11, 2016 at 3:43 PM Esteban Lorenzano wrote: > well… maintenance is (usually) just run the generation process. > Some months ago Guille made a simplified version and I was thinking on > just load it and

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Esteban Lorenzano
well… maintenance is (usually) just run the generation process. Some months ago Guille made a simplified version and I was thinking on just load it and execute it… they go to sleep :) the reasons for pharodocs to be there are not so important and nothing will change a lot if removed. But I woul

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Sven Van Caekenberghe
The point is visibility towards web users and robots. It also contains quite a bit of technology, it would be a shame to lose it. But yes, of course, real Pharo programmers will never use it, in-image browsing is so much better. Maybe a more down to earth, simpler version would be better. > O

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Esteban Lorenzano
main purposes of pharodocs were: 1) make pharo code to appear in the indexes 2) make newcomers (who are used to javadocs and lots of stuff we do not need) feel more confortable, until they realise is actually not needed :P Esteban > On 11 Jan 2016, at 14:28, Dimitris Chloupis wrote: > > yea

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Johan Fabry
I never used Pharodoc, I don’t really see the point. And apparently I am not alone. So, I have a provocative question: why don’t you just remove it? It is broken now and it will take energy to fix, and this energy can be much better spent elsewhere. Plus it will take maintenance time and energy

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Esteban Lorenzano
yeah… something is bad, but it shouldn’t :) pharodocs are statically generated when we release (it takes some time to build it). That could mean is broken since some months (and just now we realised :( ) but well, as I say… I will check it… eventually :) Esteban > On 11 Jan 2016, at 14:18, Davi

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Dimitris Chloupis
if i click on a class, displays nothing i have to also click on the method so i assume this is broken on firefox On Mon, Jan 11, 2016 at 3:14 PM Esteban Lorenzano wrote: > On 11 Jan 2016, at 14:09, Nicolai Hess wrote: > > > > 2016-01-11 13:54 GMT+01:00 Esteban Lorenzano : > >> well, pharodocs

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Esteban Lorenzano
> On 11 Jan 2016, at 14:09, Nicolai Hess wrote: > > > > 2016-01-11 13:54 GMT+01:00 Esteban Lorenzano >: > well, pharodocs look fine for me… but can be broken in other sources. > > > What happens if you click on one link ? for me, works (on Safari) > For exampl

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Dimitris Chloupis
All manual are being updated and I plan to also release static versions for each pharo release. We made great progress this year with the help of many contributors, we managed to port the entire PBE from latex to pillar and update many chapters to version 4, I have now started the porting to Pharo

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread 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

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread 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 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,

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread 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 wrote: > > >> On 11 Jan 2016, at 10:24, Dimitris Chloupis wrote: >> >> I agree with you only 100%

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Tudor Girba
Thanks. Doru > On Jan 11, 2016, at 11:40 AM, Nicolai Hess wrote: > > I opened a fogbugz issue > 17348 remove pharo documentation link > > 2016-01-11 2:37 GMT+01:00 John Pfersich : > On my iPad the docs look like this: > > > > It's an unusable mess. > > Sent from my iPad > > > On Jan 10,

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Nicolai Hess
I opened a fogbugz issue 17348 remove pharo documentation link 2016-01-11 2:37 GMT+01:00 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:

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread Sven Van Caekenberghe
> On 11 Jan 2016, at 10:24, Dimitris Chloupis 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

Re: [Pharo-users] Pharo Docs website broken

2016-01-11 Thread 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 Enterpr

Re: [Pharo-users] Pharo Docs website broken

2016-01-10 Thread David Allouche
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 r

Re: [Pharo-users] Pharo Docs website broken

2016-01-10 Thread Serge Stinckwich
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, Da

[Pharo-users] Pharo Docs website broken

2016-01-10 Thread David Allouche
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/Proto