Thanks a lot Dimitris! It was really needed. Now I can point to updated documentation in my data week workshops here. Cheers, Offray On 15/10/15 08:47, Tudor Girba wrote:

+1!

Doru

On Thu, Oct 15, 2015 at 3:05 PM, Sven Van Caekenberghe <sven@stfx.eu <mailto:sven@stfx.eu>> wrote:

Thank you for taking care of this update, this is a very important community resource.

> On 15 Oct 2015, at 14:42, Dimitris Chloupis <kilon.alios@gmail.com <mailto:kilon.alios@gmail.com>> wrote: > > First of all thanks to all the people helping with the documentation. > > Now I think its the time to replace the old PBE with UPBE , we dont need to change the website just link to the newest pdf here > > https://ci.inria.fr/pharo-contribution/view/Books/job/UpdatedPharoByExample/... > > Because UPBE at this moment is light years ahead of PBE. I just added doc for Spotter, Dark Theme, and the new Nautilus icons. > > If any of you wants to fix something on UPBE and does not have the confidence to do it directly , because you dont understand Pillar or you dont feel confident yet with Pharo you can still help me tremendously by adding your comment , your corrected text or your addition documentation as github issue here and I will put it in the book ASAP. > > https://github.com/SquareBracketAssociates/UpdatedPharoByExample/issues > > I will be resolving at least one issue per week from now on to make sure that UPBE is being pushed forward and remains by far the most up to date documentation of Pharo anywhere in this universe. But I cannot guarantee for other universes. > > So please help , even a tiny bit of help is great because we can all make Pharo far easier for newcomers with much better documentation and expand UPBE to every direction. > > All hail Pharo !

-- www.tudorgirba.com <http://www.tudorgirba.com>

"Every thing has its own flow"

thanks guys I can compromise for the time being with the user not going to the website , searching for doc and founding documentation for pharo 1.4 while the version he/she has is pharo 5 when we already have a book that is fairly up to date. Is there anyone responsible for the PBE website ? Can we make the change ? Also please use this thread to post your blog posts and own tutorials I could use for UPBE. I am in the process of reading the humaneassesment documentation but I welcome also others. Any form of tutorial or article is welcomed. On Thu, Oct 15, 2015 at 6:31 PM Damien Cassou <damien.cassou@inria.fr> wrote:

Hi Dimitris,

Dimitris Chloupis <kilon.alios@gmail.com> writes:

...

First of all thanks to all the people helping with the documentation.

Now I think its the time to replace the old PBE with UPBE, we dont need to change the website just link to the newest pdf here

I agree UPBE is important. I want to finish EnterprisePharo and the Mooc first and then focus on UPBE. I want to get printed copies of it in book stores as we did we the other books. This will take time, but with your help and the help of the community, we will get there.

-- Damien Cassou http://damiencassou.seasidehosting.st

"Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill

"Yes we can ask oscar and after will host it also at books.pharo.org and in HTML version too as for all the other books. Damien P and Damien C are working on a better latex template for pillar generated books." great to hear, I think not just UPBE but the other books need to be the first thing a newcomer sees when he or she introduced into Pharo because I think Pharo documentation is far better today that it used to be 2 years ago and we need to show the people all the hard work we have done with it. "pay attention. I think that we should minimize UI elements and external frameworks because else we will have more work in 4 years from now. " What do you mean ? As you know I am a supporter of pharo modularity but I fail to see how that is related to UPBE and I dont think documenting external frameworks is the focus of UPBE anyway just document what there is in the pharo image by default at least the core stuff that an average user is most likely to use. By any forms of tutorials and articles I did not mean that I will cram those in UPBE, if they refer to external third party libraries then I will document them in another book. But I was referring to tutorials and articles concering things that are part of the pharo image and they are beginner orientated. For example I am looking at documentation about code critics, update to the pharo catalog docs, Versionner , Kommiter etc On Fri, Oct 16, 2015 at 2:11 PM stepharo <stepharo@free.fr> wrote:

Le 15/10/15 18:12, Dimitris Chloupis a écrit :

thanks guys

I can compromise for the time being with the user not going to the website , searching for doc and founding documentation for pharo 1.4 while the version he/she has is pharo 5 when we already have a book that is fairly up to date.

Is there anyone responsible for the PBE website ? Can we make the change ?

Yes we can ask oscar and after will host it also at books.pharo.org and in HTML version too as for all the other books. Damien P and Damien C are working on a better latex template for pillar generated books.

Also please use this thread to post your blog posts and own tutorials I could use for UPBE. I am in the process of reading the humaneassesment documentation but I welcome also others. Any form of tutorial or article is welcomed.

pay attention. I think that we should minimize UI elements and external frameworks because else we will have more work in 4 years from now.

On Thu, Oct 15, 2015 at 6:31 PM Damien Cassou <damien.cassou@inria.fr> wrote:

...

Hi Dimitris,

Dimitris Chloupis <kilon.alios@gmail.com> writes:

...

First of all thanks to all the people helping with the documentation.

Now I think its the time to replace the old PBE with UPBE, we dont need to change the website just link to the newest pdf here

I agree UPBE is important. I want to finish EnterprisePharo and the Mooc first and then focus on UPBE. I want to get printed copies of it in book stores as we did we the other books. This will take time, but with your help and the help of the community, we will get there.

-- Damien Cassou http://damiencassou.seasidehosting.st

"Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill

I completely agree with Stef, I did actually removed some screenshots and someone put them pack Maybe I can create a pharo script to auto make them for each version On Fri, Oct 23, 2015 at 5:24 PM Damien Cassou <damien.cassou@inria.fr> wrote:

Dimitris Chloupis <kilon.alios@gmail.com> writes:

...

"Yes we can ask oscar and after will host it also at books.pharo.org and in HTML version too as for all the other books.

please contact "Oscar Nierstrasz" <oscar@iam.unibe.ch> to:

- get the website sources - redirect pharobyexample.org to files.pharo.org/books/pharobyexample

...

"pay attention. I think that we should minimize UI elements and external frameworks because else we will have more work in 4 years from now. "

What do you mean ?

Stephane wants to facilitate migration of UPBE to Pharo 6/7/8/... For that, the book should limit the number of screenshots and fine-grained tutorials such as "Left click Here, press the button name 'That Way', you will see a window looking like That". These fine-grained instructions are a pain to update and need to change with each version of Pharo. It is ok to have some, but not too much.

-- Damien Cassou http://damiencassou.seasidehosting.st

"Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill

On 23-10-15 19:15, Thierry Goubier wrote:

Le 23 oct. 2015 7:00 PM, "Dimitris Chloupis" <kilon.alios@gmail.com> a écrit :

...

I completely agree with Stef, I did actually removed some screenshots and

someone put them pack

...

Maybe I can create a pharo script to auto make them for each version

Wasn't there a way to run Smalltalk code inside pillar? Code that would open windows, screenshot and return a png.

Well, there is Documentation-Screenshots in StephanEggermont/Documentation You create a DOScreenshotExporter, set its directory and tell it which forms/morphs/nautilus/world you want stored there under which filename. I fixed a few remaining bugs today. I presume you should be able to use it in pillar. You can use it like so := DOScreenshotExporter new. so directory: FileLocator home. so writeNautilusMethod: DOScreenshotExporter>>#directory: as: 'directoryMethod.png' It has methods like DOScreenshotExporter>>writeNautilusMethod: aMethod as: aFileName self writeBlock: [(Nautilus openOnMethod: aMethod) ui window imageForm ] as: aFileName This makes sure to first rename an existing file before overwriting it. DOScreenshotExporter>>writeBlock: aBlock as: aFileName |temp| (directory / aFileName) exists ifTrue: [ temp := (directory / aFileName) renameTo: (aFileName,'tmp') ]. PNGReadWriter putForm: aBlock value onFileNamed: (directory / aFileName). temp ifNotNil: [ temp ensureDelete ] Stephan

Hello Mariano, thank you for your kind word of course I am one of the many contributors and UPBE is a collective effort. We dont have an image right now for UPBE and I think that the best way to approach this is to make a package for the Catalog Browser . This means you will be able to use UPBE examples to any image you have instead of being isolated to a different image. When this will happen I cant promise anything since our first priority is to make the documentation as up to date as possible. Currently we support Pharo 4 and 5 , with focus of course on Pharo 5. Obviously in the future the focus will continuously shift towards the latest version. So when we put the "Updated" to Pharo by Example, we mean business. On Mon, Oct 26, 2015 at 6:04 PM Mariano Martinez Peck <marianopeck@gmail.com> wrote:

Hi Dimitris,

Thank you very much for your hard work. It was so much needed. In fact, I need it now :) I have question... remember the old PBE used to have a VM + image for the book, which was the image expected to be used while reading the book. Is there a new VM + image prepared for UPBE? If true, where? If not, then at least which Pharo version is expected to be used as a reference? 4.0?

Thanks in advance,

On Fri, Oct 23, 2015 at 4:19 PM, Stephan Eggermont <stephan@stack.nl> wrote:

...

On 23-10-15 19:15, Thierry Goubier wrote:

...

Le 23 oct. 2015 7:00 PM, "Dimitris Chloupis" <kilon.alios@gmail.com> a écrit :

...

I completely agree with Stef, I did actually removed some screenshots and

someone put them pack

...

Maybe I can create a pharo script to auto make them for each version

Wasn't there a way to run Smalltalk code inside pillar? Code that would open windows, screenshot and return a png.

Well, there is Documentation-Screenshots in StephanEggermont/Documentation

You create a DOScreenshotExporter, set its directory and tell it which forms/morphs/nautilus/world you want stored there under which filename. I fixed a few remaining bugs today.

I presume you should be able to use it in pillar.

You can use it like

so := DOScreenshotExporter new. so directory: FileLocator home. so writeNautilusMethod: DOScreenshotExporter>>#directory: as: 'directoryMethod.png'

It has methods like DOScreenshotExporter>>writeNautilusMethod: aMethod as: aFileName self writeBlock: [(Nautilus openOnMethod: aMethod) ui window imageForm ] as: aFileName

This makes sure to first rename an existing file before overwriting it.

DOScreenshotExporter>>writeBlock: aBlock as: aFileName |temp| (directory / aFileName) exists ifTrue: [ temp := (directory / aFileName) renameTo: (aFileName,'tmp') ]. PNGReadWriter putForm: aBlock value onFileNamed: (directory / aFileName). temp ifNotNil: [ temp ensureDelete ]

Stephan

-- Mariano http://marianopeck.wordpress.com

The possibility to take automatic screenshot should be added to Pillar but for now it's just an idea and no one have the time to do it. On Fri, Oct 23, 2015 at 6:59 PM, Dimitris Chloupis <kilon.alios@gmail.com> wrote:

I completely agree with Stef, I did actually removed some screenshots and someone put them pack

Maybe I can create a pharo script to auto make them for each version

-- Cheers Cyril Ferlicot

I agree and its a good thinking you created this issue. There is no commitment, no obligation, no strings attaches. We all do what we want to do. Just because you report an issue does not mean you have to solve the issue. Reporting an issue is already very helpful and pharo really needs reporting of issues whether is with the documentation or pharo itself. This is why I never asked for more people to contribute rather I asked for existing resources that I have not noticed . On Fri, Oct 16, 2015 at 8:55 PM Lyn Headley <laheadle@gmail.com> wrote:

[I have submitted the following issue but am posting here for the sake of discussion]

Pharo is used by software developers, and software developers depend on packages. Therefore I believe that one of the first things a new Pharo user will want to do is install packages written by others. But Pharo By Example contains no mention of the ConfigurationOfXYZ method of installing packages (and does not mention the configuration browser -- an awesome tool for new users to get excited about what is out there). You could introduce these topics without getting too deep into Metacello, but...

I also think Metacello should be introduced fairly early. Any application will almost certainly have dependencies and it is important to be able to load your application into a fresh image. Metacello is essential for this, so it is essential for Pharo.

Chapter 8 could probably be expanded to include these topics, which are more fundamental than Morphic or Seaside. Note that the Seaside chapter recommends installing an old one-click image! This is a great chance to use Configurations.

What do you think of this idea? And yes, I realize I can contribute this myself, but I currently decline the commitment.

Lyn

On Thu, Oct 15, 2015 at 5:42 AM, Dimitris Chloupis <kilon.alios@gmail.com> wrote:

...

First of all thanks to all the people helping with the documentation.

Now I think its the time to replace the old PBE with UPBE , we dont need to change the website just link to the newest pdf here

https://ci.inria.fr/pharo-contribution/view/Books/job/UpdatedPharoByExample/...

Because UPBE at this moment is light years ahead of PBE. I just added doc for Spotter, Dark Theme, and the new Nautilus icons.

If any of you wants to fix something on UPBE and does not have the confidence to do it directly , because you dont understand Pillar or you dont feel confident yet with Pharo you can still help me tremendously by adding your comment , your corrected text or your addition documentation as github issue here and I will put it in the book ASAP.

https://github.com/SquareBracketAssociates/UpdatedPharoByExample/issues

I will be resolving at least one issue per week from now on to make sure that UPBE is being pushed forward and remains by far the most up to date documentation of Pharo anywhere in this universe. But I cannot guarantee for other universes.

So please help , even a tiny bit of help is great because we can all make Pharo far easier for newcomers with much better documentation and expand UPBE to every direction.

All hail Pharo !