<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
On 5/12/2025 6:08 PM, Hilaire Fernandes via Cuis-dev wrote:
<blockquote cite="mid:abcd5408-eeb9-4760-a0db-5a9840503d1f@free.fr"
type="cite">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<p><font size="4">Hi, <br>
</font></p>
<p><font size="4">Some update at <a moz-do-not-send="true"
class="moz-txt-link-freetext"
href="http://github.com/DrCuis">http://github.com/DrCuis</a>,
the known documentation is spread in four categories</font></p>
<pre class="moz-signature" cols="72">--
<a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://mamot.fr/@drgeo">http://mamot.fr/@drgeo</a></pre>
</blockquote>
<br>
Hi Hilaire,<br>
<br>
I've had a quick look at the main 4 repositories:<br>
<br>
<a class="moz-txt-link-freetext" href="https://github.com/DrCuis/Tutorials">https://github.com/DrCuis/Tutorials</a><br>
<a class="moz-txt-link-freetext" href="https://github.com/DrCuis/How-to-guides">https://github.com/DrCuis/How-to-guides</a><br>
<a class="moz-txt-link-freetext" href="https://github.com/DrCuis/References-guides">https://github.com/DrCuis/References-guides</a><br>
<a class="moz-txt-link-freetext" href="https://github.com/DrCuis/Explanations">https://github.com/DrCuis/Explanations</a><br>
<br>
I think that Tutorials is OK. "Tutorials" is a meaningful subset of
"Documentation". I would expect this repo to grow to reflect the
needs and desires of new users an old users exploring new areas.<br>
<br>
"How-to guides" also makes a lot of sense. However I would
completely remove the "Virtual Machine" section. Cuis-Smalltalk-Dev
already includes VMs for major platforms. 99% of Cuis users don't
need to build a VM. Helping the other 1% is fine, but I think that
is "Pro Level" documentation and it belongs somewhere else. Having
that in the same place as building packages or working with layouts
may make people think that hacking the VM is as important or
frequent as doing packages and layouts. Even worse. It may lead
people to believe that building their own package or using Layouts
in their code is as difficult and "experts only" as hacking the VM.
We provide well tested VMs for most platforms so people can forget
about this as much as possible.<br>
<br>
"Reference guides" is OK. I think that other reference material
could be added here. Perhaps the services offered by MorphicCanvas
would belong here. Or some comprehensive discussion about Unicode.
I'm sure there are many more that don't come to my mind right now.<br>
<br>
"Explanations" looks like a place to put stuff that didn't belong in
any of the previous categories. Currently it includes both
introductory material, highly technical stuff, and lose bits of
information. I think this could be improved. For instance,
separating "Philosophical" and "Technical" material as done in
Cuis-Smalltalk-Dev/Documentation, makes sense to me.<br>
<br>
Additionally, the question remains whether this should duplicate the
material in Cuis-Smalltalk-Dev/Documentation, or which parts belong
in DrCuis, and witch belong in Cuis-Smalltalk-Dev.<br>
<br>
Thanks,<br>
<pre class="moz-signature" cols="72">--
Juan Vuletich
cuis.st
github.com/jvuletich
researchgate.net/profile/Juan-Vuletich
independent.academia.edu/JuanVuletich
patents.justia.com/inventor/juan-manuel-vuletich
linkedin.com/in/juan-vuletich-75611b3
twitter.com/JuanVuletich</pre>
</body>
</html>