I just purchased squeakbooks.com and .org

Hi folks,

I am going to try to recreate books.pharo.org using those domains, but for Squeak as part of my Doc/SeasideDoc project.

I am NOT trying to make money for myself, I am just trying to solve the Squeak documentation problem.

I will be building the site with Seaside on Squeak and I will be studying the Pharo model for their documentation creation to see if it is appropriate for squeak.

Motivation:  http://books.pharo.org/booklet-Scraping/html/scrapingbook.html

That is an example of the type of documentation I frequently use as a developer. How do I accomplish a specific task, where do I start, what are the conceptual "things" I have to think in.

I will be using that documentation to get myself familiarized with the Squeak XML stuff as I will need it for processing xml documents of 10's of millions of records.

I will be happy to give the domains to the squeak community when/if the project is solid.

Once the stubbed website is up, I will attempt to create a live-round-robin model from the squeak image.

Open a workspace, open a book (book content comes down from website) add/edit content within the workspace, save it live to the website (and concurrently to the image ?)

Hopefully it will be useful and we can start crowdsourcing documentation.

cheers,

tty.

 

> But the HelpBrowser is read only at the moment. (Some skeleton methods exist for writing documentation)

I uploaded a lot of stuff concerning this to the inbox last year. Unless you want to achieve something very fancy, you do not need to descend into the System Browser any longer. Creating, removing, renaming, and editing topics is all possible via the HelpBrowser. Moreover, with Morphic-ct.1587, you can even insert images without writing code. :-)

The changes are still waiting for anyone who has some time to review and eventually merge them.

Best,

Christoph

---

Von: Squeak-dev <[hidden email]> im Auftrag von karl ramberg <[hidden email]>
Gesendet: Freitag, 4. September 2020 15:24:06
An: gettimothy; The general-purpose Squeak developers list
Betreff: Re: [squeak-dev] I just purchased squeakbooks.com and .org

 

On Fri, Sep 4, 2020 at 1:29 PM gettimothy via Squeak-dev <[hidden email]> wrote:

Hi folks,

I am going to try to recreate books.pharo.org using those domains, but for Squeak as part of my Doc/SeasideDoc project.

I am NOT trying to make money for myself, I am just trying to solve the Squeak documentation problem.

I will be building the site with Seaside on Squeak and I will be studying the Pharo model for their documentation creation to see if it is appropriate for squeak.

Motivation:  http://books.pharo.org/booklet-Scraping/html/scrapingbook.html

That is an example of the type of documentation I frequently use as a developer. How do I accomplish a specific task, where do I start, what are the conceptual "things" I have to think in.

I will be using that documentation to get myself familiarized with the Squeak XML stuff as I will need it for processing xml documents of 10's of millions of records.

I will be happy to give the domains to the squeak community when/if the project is solid.

Once the stubbed website is up, I will attempt to create a live-round-robin model from the squeak image.

Open a workspace, open a book (book content comes down from website) add/edit content within the workspace, save it live to the website (and concurrently to the image ?)

It would be a really nice addition to be able to write "how to's" and documentation in an almost literal coding style within Squeak.

The HelpBrowser has the ability to pull down content from the Squeak Wiki.

And we have added inlining pictures in it:

http://forum.world.st/The-Trunk-MonticelloConfigurations-mt-160-mcz-td5115112.html#a5116431

But the HelpBrowser is read only at the moment. (Some skeleton methods exist for writing documentation)

Best,

Karl

Hopefully it will be useful and we can start crowdsourcing documentation.

cheers,

tty.