Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-11 Thread Offray Vladimir Luna Cárdenas
Hi Ted, Don't worry and take your time. I tend to write looong (this list should be thankful of English not being my first language and I mostly self learned after crappy courses, if not, you will have me writing even longer ;-P). About entry points, one of the things I like about Pharo is that

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-11 Thread tbrunz
Hi Offray, Just wanted to let you know that I enjoyed your several responses, and that I'm working on following-up to them. But first I wanted to look at all your links and make as thoughtful a reply as you have, and that takes a while... I think what you've been working on could be a good

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-06 Thread Stéphane Ducasse
> One more thought on this... I assume you've seen Jupyter Notebooks? > They're starting to see some use where I work (we now have our own > 'enterprise server'). I recently took an intro class to see how it works, > and how to use them. > > How much of a "Jupyter-style" notebook capability

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-05 Thread tbrunz
> >>> I've been thinking lately that it would be nice to expand the number of > >>> Pharo tutorials we have available. But rather than (or along with) > >>> creating > >>> more "beginner" level tutorials, I'd like to see some good > "intermediate" > >>> level Pharo tutorials. > >> > >> Me

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-05 Thread Offray Vladimir Luna Cárdenas
Hi again :-), I forgot to mention about the Spec2 migration plans, so a (hopefully) short comment on that. Last ESUG I talked with Guille and Esteban about combining Spec(1) and Spec2 in a single interface. The idea is to be able to embed Spec old widgets into Spec2, as they are progressively

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-05 Thread Offray Vladimir Luna Cárdenas
Hi, On 5/08/20 9:43 a. m., tbrunz wrote: >>> Okay, I'll do that. But this brings up a more general question... >>> >>> If I wanted to add a diagram, or maybe a document with equations >> (rendered >>> in LaTex), then a class comment wouldn't work. >>> >>> ...Unless that's intended to be part

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-05 Thread tbrunz
Hi Offray, I think you're addressing many of the same concerns as I am, with more of a web/browser orientation perhaps... Which is good. Pharo can make nice, interactive web sites as well as nice, interactive documents, can it not? > I think that we still can make a compelling case for wider

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-05 Thread tbrunz
> > Okay, I'll do that. But this brings up a more general question... > > > > If I wanted to add a diagram, or maybe a document with equations > (rendered > > in LaTex), then a class comment wouldn't work. > > > > ...Unless that's intended to be part of the newer format?? > > > Microdown

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-05 Thread Stéphane Ducasse
> Okay, I'll do that. But this brings up a more general question... > > If I wanted to add a diagram, or maybe a document with equations (rendered > in LaTex), then a class comment wouldn't work. > > ...Unless that's intended to be part of the newer format?? Microdown supports latex via

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-04 Thread Offray Vladimir Luna Cárdenas
Hi, Is nice to see this thread. Our approach to building documentation is a problem/local first one. So we go from particular problems/projects as need of the community  dictate them. We do workshops and create the documentation while the workshop is happening and then we compile such

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-04 Thread tbrunz
Okay, I'll do that. But this brings up a more general question... If I wanted to add a diagram, or maybe a document with equations (rendered in LaTex), then a class comment wouldn't work. ...Unless that's intended to be part of the newer format?? -t > I would put it in class comment. > >

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-04 Thread Stéphane Ducasse
I would put it in class comment. We are about to release a nicer rendering of comments. S. > On 4 Aug 2020, at 06:46, tbrunz wrote: > > I wrote a "theory of operation" document for my app, > https://github.com/tbrunz/logic-puzzle > > But then I realized, "Where do I put it??" > > I

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-03 Thread tbrunz
I wrote a "theory of operation" document for my app, https://github.com/tbrunz/logic-puzzle But then I realized, "Where do I put it??" I thought of a few possibilities: * Commit it to the git repo, but then it wouldn't be easy to access from Pharo, * Add it to a top-level Pharo class comment,

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Stéphane Ducasse
Hi Thanks I was planning to implement it. I asked Esteban to take the time to integrate my PR. Now can you send some PRs to the version of esteban like that we will get a better version. And you can open issues on his repo We will fix them. S > On 2 Aug 2020, at 20:22, Russ Whaley wrote:

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Russ Whaley
Well, the very next step in the tutorial says: How does this look? Now we can open our task list manager as follows: TODOApplication new run. However, TODOApplication has not yet been connected to anything... displaying the UI that is depicted in the tutorial is not achievable at this point...

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Russ Whaley
Here are a couple of items with my first 5 minutes with the TODO tutorial... TODOListPresenter >> initializePresenters todoListPresenter := self newTable addColumn: ((SpCheckBoxTableColumn evaluated: [:task | task isDone]) width: 20); addColumn:

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread tbrunz
>> Let's do it, then. I'll volunteer to do most of the work. :^) > >I will review anything you write :) I'll write well and add lots of comments to make that easy for you. :^D >> My hope is that participating in this will make me capable of creating >> advanced tutorials all by myself. > >I

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Stéphane Ducasse
> On 2 Aug 2020, at 19:51, tbrunz wrote: > >>> I've been thinking lately that it would be nice to expand the number of >>> Pharo tutorials we have available. But rather than (or along with) >>> creating >>> more "beginner" level tutorials, I'd like to see some good "intermediate" >>> level

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread tbrunz
>> I've been thinking lately that it would be nice to expand the number of >> Pharo tutorials we have available. But rather than (or along with) >> creating >> more "beginner" level tutorials, I'd like to see some good "intermediate" >> level Pharo tutorials. > >Me too :) Let's do it, then.

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Stéphane Ducasse
> On 2 Aug 2020, at 15:33, Russ Whaley wrote: > > EXACTLY!, Stéphane, thank you! I will go through this tutorial today. > > Has anyone written any documentation or maybe a tool that would help > understand what each ‘widget’ is capable of? I review all example code, read > all class

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Russ Whaley
EXACTLY!, Stéphane, thank you! I will go through this tutorial today. Has anyone written any documentation or maybe a tool that would help understand what each ‘widget’ is capable of? I review all example code, read all class comments and peruse the class hierarchy, but when a widget capability

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Stéphane Ducasse
> On 29 Jul 2020, at 05:06, Russ Whaley wrote: > > Back on the 'Intermediate Tutorials' question... > > I would love to see intermediate tutorials on Spec2 and Seaside and > perhaps how to best adapt an (Sp)Application to serve both 'presenters' with > guidelines on what responsibility

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-02 Thread Stéphane Ducasse
> On 28 Jul 2020, at 05:38, tbrunz wrote: > > tl;dr: I have some ideas about more advanced Pharo tutorials, and I have an > example that I would like to have reviewed/critiqued before I develop it any > further. > > I've been thinking lately that it would be nice to expand the number of >

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-08-01 Thread tbrunz
Hi Russ, I added an "Examples" package tag, with several methods that lead through the Zebra Puzzle solution, step by step. It still doesn't do the entire solution by itself, but each example method displays the solution state up to that point, allowing you to examine the results and infer

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-07-29 Thread tbrunz
I also would love to see intermediate tutorials on Spec2 and Seaside. (And Zinc and Teapot, too, for that matter.) And the example/tutorial I'm working on really *should* have a Spec2 _and_ a Seaside/Teapot interface. But that's a bit over my head... Which is frustrating; I want to know how to

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-07-28 Thread Russ Whaley
Back on the 'Intermediate Tutorials' question... I would love to see intermediate tutorials on Spec2 and Seaside and perhaps how to best adapt an (Sp)Application to serve both 'presenters' with guidelines on what responsibility goes where on the presenter/component, application, and model(s).

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-07-27 Thread tbrunz
So I decided to write an application to solve the Zebra Puzzle, by solving this type of problem in general. In Pharo, of course. I worked out a few basic algorithms for making deductions and inferences, and coded them, along with tests, in Pharo 8. Now I've reached the point of having a

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-07-27 Thread tbrunz
Having solved a number of these problems in my youth, I tried to solve this one "by hand". But with 6 attributes of 5 properties each, the "bookkeeping" task was too difficult to deal with while trying to find a consistent solution. It turns out that it's very easy to make an inconsistent

Re: [Pharo-users] Intermediate-Level Tutorials for Pharo

2020-07-27 Thread tbrunz
Recently, I came up with one such project that might work here, and I spent some time prototyping it. The project is to create an application in Pharo that can solve the "Zebra Puzzle". What's the Zebra Puzzle? It's an example of a "constraint satisfaction problem", which are also known as

[Pharo-users] Intermediate-Level Tutorials for Pharo

2020-07-27 Thread tbrunz
tl;dr: I have some ideas about more advanced Pharo tutorials, and I have an example that I would like to have reviewed/critiqued before I develop it any further. I've been thinking lately that it would be nice to expand the number of Pharo tutorials we have available. But rather than (or along