[Cuis-dev] Documenting...

[rabbit]

Good morning, I'm using GitBook.io to document HymnPOarratTalk and my other projects too. I figured out how to link to a project I have in GitHub, though I no longer recall how I did so. There are instructions. And GitBook has my GitHub account linked.

I was able to get GitBook admin to approve my non-profit, Callisto House, such that I am still on the 'Community' plan but they have authorized me to be able to export my projects as PDFs. I think the same authority of PDF export would be extended to Cuis.

I highly recommend GitBook as a mechanism of good documentation supporting multiple collaborators. They are just commits to the GitHub project. Check out the results...

> HymnParrotTalk :: https://callistohouseltd.gitbook.io/parrottalk/

HTH,
- rabbit

On 8/13/23 04:35, Hilaire Fernandes via Cuis-dev wrote:

> Hi Bernhard,
>
> I was thinking about something less formal than "Cuis By Example", and hopefully easier to write collaboratively, covering different topics as the ones you mentioned.
>
> When those contents are rich enough, we edit them individually as mini book (< 50 pages), both PDF and html. It will make a valuable collection and it will improve the visibility of Cuis.
>
> Hilaire
>
> Le 02/08/2023 à 18:05, Bernhard Pieber a écrit :
>
>> Hi,
>>
>> I note that recently an updated version of Squeak by Example was published. It is maintained here:
>> https://github.com/hpi-swa-lab/SqueakByExample-english
>> Here is the link to the PDF:
>> https://github.com/hpi-swa-lab/SqueakByExample-english/releases/tag/6.0
>> I just skimmed it and I am sure a lot of chapters would be almost identical. If we just took those we could probably save a lot of work. OTOH, we would definitely need Cuis specific chapters on Morphic, VectorGraphics, Packages, Files, and Unicode. So, to make a Cuis by Example would still be a lot of work. Personally, I do really like that the output is a PDF.
>>
>> Cheers,
>> Bernhard
>
> --
> GNU Dr. Geo
> http://drgeo.eu
>
> http://blog.drgeo.eu

--
••• rabbit ❤️‍🔥🐰
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20230813/5a2aebee/attachment.htm>