[Cuis-dev] Dr Cuis

Hilaire Fernandes hfern at free.fr
Sun May 25 01:14:20 PDT 2025


Hi Juan,

Answers in-lined.

Le 19/05/2025 à 20:25, Juan Vuletich a écrit :
> "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.

Noted, I agree under the "first impression count" perspective. It may 
give an unjustified feeling of difficulty.

  I just removed it.


>
> "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.
>
> "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.

The idea is to have deeper understanding, in both a technical 
perspective (it may relate to the Technique repo) and more large scale 
perspective (aka philosophical). The latter one may be the one not 
fitting this category as described in the documentation system, but we 
are free to diverge.

>
> 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.

Duplication may result in wasted resources.

Options: keeping VM, plugin, FFI to Cuis-Smalltalk-Dev, and other more 
/classic user/ at DrCuis



-- 
http://mamot.fr/@drgeo
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20250525/70f3c452/attachment.htm>


More information about the Cuis-dev mailing list