Updated Pharo By Example

Hi Dimitris,

Dimitris Chloupis <[hidden email]> 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

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 <[hidden email]> wrote:

Hi Dimitris,

Dimitris Chloupis <[hidden email]> 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 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 <[hidden email]> 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/lastSuccessfulBuild/artifact/book-result/UpdatedPharoByExample.pdf

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 !

Dimitris Chloupis <[hidden email]> 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" <[hidden email]> 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

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 <[hidden email]> wrote:

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

Le 23 oct. 2015 7:00 PM, "Dimitris Chloupis" <[hidden email]> 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