- Pharo-users - lists.pharo.org

Re: [Pharo-users] Essential Documentation

by Offray Vladimir Luna CÃ¡rdenas

Julius, On the interactive documentation front I'm working in a project called Grafoscopio. Now it has a translated English main page at [1]. Is not for writing code documentation, but for writing tutorials, books and alike that mix prose, code, data and visualizations, think in something similar to Mathematica or Jupyter notebooks, but with an outline structure to hold a complete book (instead of the common pile of files inside folders approach) or support complex explorative writing/computing. See an example of this at [2]. It can also produce pdf outputs (via pandoc), like the two draft documents at [3] and [4], made in grafoscopio [1] http://mutabit.com/grafoscopio/index.en.html [2] http://mutabit.com/offray/blog/en/entry/panama-papers-1 [3] http://mutabit.com/repos.fossil/grafoscopio/doc/tip/Docs/Es/Articulos/Liber… [4] http://mutabit.com/repos.fossil/piamed/doc/tip/Libro/libro.pdf My approach to build such app was to start with the simplest prototype, using Glamorous Toolkit [5] and reading the useful chapters of Deep into Pharo [6] about Glamour (chap. 10), Files with the FileSystem (chap. 3) Versioning Your Code with Monticello (chap 7), Gofer: Scripting Package Loading (chap 8), the paper on ston [7] and then the Agile Visualization Book [8] and ask questions in this mailing list. I skipped the Pharo by example book, because the game building approach was not what I wanted/needed, so I filled a lot of gaps in my knowledge with the recent Pharo MOOC [9]. [5] http://gtoolkit.org/ [6] http://deepintopharo.com/ [7] https://github.com/svenvc/ston/blob/master/ston-paper.md [8] http://agilevisualization.com/ [9] http://files.pharo.org/mooc/ As you can see my learning process was problem/project oriented and that was the path I followed to build my "essential documentation". Being the only Smalltalker active in my country (AFAIK) was kind of difficult, but in the virtual space you can find a community that is welcoming, proactive and responsive most of the time. Now I'm trying to enlarge the community by serving a different public (non-programmers like me) that are interested in data storytelling, visualization and (h)ac(k)tivism ( journalists, non computer science academics, activist, philosophers, etc). So even if Pharo doesn't have the classical documentation, the community around it, the documentation and the environment, can support alternative learning paths, driven by exploration and problem solving and I hope you can find a place and path here for your project. Welcome here Julius, Offray On 23/09/16 11:16, julius wrote: > Probably this is a very beginners question but is there a documentation > online > or within the Pharo image for all the base-framework components like all > collections, Morphic, Numbers and so on? > > I know Pharo uses a lot the 'see and discover yourself' approach but > sometimes, > especially for beginners it would be nice to have a documentation for most > classes > and also have programming guides. Coming from macOS and iOS development I > think about something like Swift or Objective-C has. For example you have > every > class there documented but also you have programming guides for how to draw > graphics. It would be really helpful to have somthing like that for example > for > Voyage (maybe it's there but I did not found it). > > Thanks for helping me out! > Julius > > > > -- > View this message in context: http://forum.world.st/Essential-Documentation-tp4916861.html > Sent from the Pharo Smalltalk Users mailing list archive at Nabble.com. > >

Sept. 27, 2016

Re: [Pharo-users] Why Pharo?

by Stephan Eggermont

On 26/09/16 17:57, stepharo wrote: > to me research vehicule could be perceived negatively. There are a lot of people for which research vehicule is negative. In Crossing the Chasm, Geoffrey Moore describes well the difference between innovators, early adopters, early and late majority and laggards. This directly targets innovators and early adopters, who like challenges. In a legacy-code environment, you're likely to find more late majority and laggard attitude. There Wardley mapping is likely to be helpful to limit and control the scope of innovation. Pharo is the state of the art in software development, and we can only stay ahead by being a research vehicule. Stephan

Sept. 26, 2016

Re: [Pharo-users] Mustache templates listed the in Mustache site

by Ben Coman

Cool! We should do more of that. Part of building exposure. Is it known to work on more than "pharo smalltalk 2.0" ? Perhaps an "Update" can be inserted on the page. cheers -ben On Mon, Sep 26, 2016 at 9:28 PM, Esteban A. Maringolo <emaringolo(a)gmail.com> wrote: > Some months ago I sent a pull request [1] to add Smalltalk/Pharo to the list > of supported languages in Mustache home page <http://mustache.github.io/>. > > Took some time but now it is in the front page. > > Thank you Norbert Hartl for this useful library. > > Regards! > > Esteban A. Maringolo > > [1] https://github.com/mustache/mustache.github.com/pull/77

Sept. 26, 2016

Re: [Pharo-users] Why Pharo?

by Offray Vladimir Luna CÃ¡rdenas

Hi, On 25/09/16 06:07, Stephan Eggermont wrote: > I finally found the time to put the slides and narrative together > > https://medium.com/@stephan_32833/pharo-50c66685913c#.jeou548z7 > Thanks a lot Stephan! The timing is really good, because we started the 5th edition of the our Data Week workshop/hackathon last weekend and I will be sharing with the participants for the next weekend (the Data Week is split in two weekends sessions from Thursday to Saturday). It's a short narrative with relevant points. Dealing with complexity and trying to find the proper balance between research and production using fast feedback loops, provides Pharo with a unique position and your story telling, accounts for this in a concise yet compelling fashion. Cheers, Offray Ps: As usual, we will be sharing some processes / results of the 5th Data Week, with the Pharo community.

Sept. 26, 2016

Re: [Pharo-users] Why Pharo?

by stepharo

stefan to me research vehicule could be perceived negatively. Stef Le 25/9/16 Ã 14:07, Stephan Eggermont a Ã©crit : > I finally found the time to put the slides and narrative together > > https://medium.com/@stephan_32833/pharo-50c66685913c#.jeou548z7 > > Stephan > > >

Sept. 26, 2016

Re: [Pharo-users] Why Pharo?

by stepharo

Once I sadi to my students that for something doing nothing zero is the right size :) So everything is a question of ratio. Le 25/9/16 Ã 16:45, Tudor Girba a Ã©crit : > Hi, > >> On Sep 25, 2016, at 2:01 PM, Dimitris Chloupis <kilon.alios(a)gmail.com> wrote: >> >> Totally agree with the slides apart from "Pharo is Small" , the syntax may be but the whole environment last time I checked was 700k lines of code >> which is huge for a dynamic language. Of course that is far from bad at least for me, I love powerful environments over minimal solutions. > > Just for reference, Pharo 5 has: > Smalltalk allClasses sumNumbers: #linesOfCode â515500" > > This is still a lot, but we should compare against a language + IDE + compiler + collections + version management system + project dependency system + several significant other libraries. This might turn out to be quite small in the end :). > > But, one thing I would stress is that "Pharo is Uniformâ. This is what in the end makes it seem âSmallâ. > > > Cheers, > Doru > > > >> You reminded me that I neeed to update my "Why Pharo" video :) >> >> Great work >> >> On Sun, Sep 25, 2016 at 2:43 PM Sven Van Caekenberghe <sven(a)stfx.eu> wrote: >> Hi Stephan, >> >>> On 25 Sep 2016, at 13:07, Stephan Eggermont <stephan(a)stack.nl> wrote: >>> >>> I finally found the time to put the slides and narrative together >>> >>> https://medium.com/@stephan_32833/pharo-50c66685913c#.jeou548z7 >>> >>> Stephan >> Great article, super cool slides, well done. I especially appreciate how you guys managed to make so many good points in such a deceptively simple and clear textâââthat takes a lot of work. >> >> Any chance you would like to submit it too 'Concerning Pharo' publication [https://medium.com/concerning-pharo] ? Just send a submission and I would love to add it. >> >> Sven >> >> > -- > www.tudorgirba.com > www.feenk.com > > "If you can't say why something is relevant, > it probably isn't." > > >

Sept. 26, 2016

Re: [Pharo-users] Why Pharo?

by stepharo

Really nice Le 25/9/16 Ã 14:07, Stephan Eggermont a Ã©crit : > I finally found the time to put the slides and narrative together > > https://medium.com/@stephan_32833/pharo-50c66685913c#.jeou548z7 > > Stephan > > >

Sept. 26, 2016

Re: [Pharo-users] Mustache templates listed the in Mustache site

by stepharo

superb :) Le 26/9/16 Ã 16:28, Esteban A. Maringolo a Ã©crit : > Some months ago I sent a pull request [1] to add Smalltalk/Pharo to > the list of supported languages in Mustache home page > <http://mustache.github.io/>. > > Took some time but now it is in the front page. > > Thank you Norbert Hartl for this useful library. > > Regards! > > Esteban A. Maringolo > > [1] https://github.com/mustache/mustache.github.com/pull/77

Sept. 26, 2016

Amazon drive API's for Pharo ?

by CÃ©drick BÃ©ler

Hi all, Iâve just seen that the unlimited offer that Amazon proposes for its drive is now available in France. !! Itâs 70â¬/year so quite cheapâ¦ Do people know if there are pharo packages to uses its RESTful API ? https://developer.amazon.com/public/apis/experience/cloud-drive/content/res… TIA (Iâll investigate deeper shortly), CÃ©drik

Sept. 26, 2016

Mustache templates listed the in Mustache site

by Esteban A. Maringolo

Some months ago I sent a pull request [1] to add Smalltalk/Pharo to the list of supported languages in Mustache home page < http://mustache.github.io/>. Took some time but now it is in the front page. Thank you Norbert Hartl for this useful library. Regards! Esteban A. Maringolo [1] https://github.com/mustache/mustache.github.com/pull/77

Sept. 26, 2016