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.
On Fri, Sep 4, 2020 at 1:29 PM gettimothy via Squeak-dev < squeak-dev@lists.squeakfoundation.org> 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-td511511...
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.
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 squeak-dev-bounces@lists.squeakfoundation.org im Auftrag von karl ramberg karlramberg@gmail.com 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 <squeak-dev@lists.squeakfoundation.orgmailto:squeak-dev@lists.squeakfoundation.org> wrote: Hi folks,
I am going to try to recreate books.pharo.orghttp://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-td511511...
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.
On Fri, Sep 4, 2020 at 3:49 PM Thiede, Christoph < Christoph.Thiede@student.hpi.uni-potsdam.de> wrote:
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.
Wow, lots of stuff here. Not sure I understand all of it.
Do you have a short description for creating a new help topic after filing in all the changes ? :-D
Best, Karl
Best, Christoph
*Von:* Squeak-dev squeak-dev-bounces@lists.squeakfoundation.org im Auftrag von karl ramberg karlramberg@gmail.com *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 < squeak-dev@lists.squeakfoundation.org> 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-td511511...
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.
Hi Karl,
basically, you can reach all new operations by opening a context menu on a help topic in the tree pane on the left of a help browser. Then choose 'Add topic...', 'Browse topic' etc. Does this help? :-)
Best,
Christoph
http://www.hpi.de/ ________________________________ Von: Squeak-dev squeak-dev-bounces@lists.squeakfoundation.org im Auftrag von karl ramberg karlramberg@gmail.com Gesendet: Samstag, 5. September 2020 18:35:12 An: The general-purpose Squeak developers list Betreff: Re: [squeak-dev] I just purchased squeakbooks.com and .org
On Fri, Sep 4, 2020 at 3:49 PM Thiede, Christoph <Christoph.Thiede@student.hpi.uni-potsdam.demailto:Christoph.Thiede@student.hpi.uni-potsdam.de> wrote:
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.
Wow, lots of stuff here. Not sure I understand all of it.
Do you have a short description for creating a new help topic after filing in all the changes ? :-D
Best, Karl
Best, Christoph
________________________________ Von: Squeak-dev <squeak-dev-bounces@lists.squeakfoundation.orgmailto:squeak-dev-bounces@lists.squeakfoundation.org> im Auftrag von karl ramberg <karlramberg@gmail.commailto:karlramberg@gmail.com> Gesendet: Freitag, 4. September 2020 15:24:06 An: gettimothy; The general-purpose Squeak developers list Betreff: Re: [squeak-dev] I just purchased squeakbooks.comhttp://squeakbooks.com and .org
On Fri, Sep 4, 2020 at 1:29 PM gettimothy via Squeak-dev <squeak-dev@lists.squeakfoundation.orgmailto:squeak-dev@lists.squeakfoundation.org> wrote: Hi folks,
I am going to try to recreate books.pharo.orghttp://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-td511511...
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.
squeak-dev@lists.squeakfoundation.org
-
gettimothy -
karl ramberg -
Thiede, Christoph