<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p><font size="+1">Hi Juan,</font></p>
    <p><font size="+1">The license could be Creative Common
        Attribution-Share Alike as the Squeak/Pharo by Example books
        from where we could pickup some parts, the Smalltalk ones (I
        wrote the original Morphic chapter, in French).</font></p>
    <p><font size="+1">I briefly took a look at documentation systems,
        Spinx[1] looks interesting and largely used. It will require
        some effort to export to the Euridite wiki like original editing
        format though. There are numerous use case examples to visit[2].<br>
      </font></p>
    <p><font size="+1">[1] <a class="moz-txt-link-freetext" href="https://www.sphinx-doc.org/en/master/">https://www.sphinx-doc.org/en/master/</a><br>
      </font></p>
    <p>[2] <a class="moz-txt-link-freetext" href="https://www.sphinx-doc.org/en/master/examples.html">https://www.sphinx-doc.org/en/master/examples.html</a></p>
    <p><br>
    </p>
    <p>Yes to a preface explaining the origin of Cuis!</p>
    <p>Regarding the "Configuring Cuis Smalltalk environment" section,
      in my mind, it is a tour to the Cuis GUI to customize it to the
      personal tastes of the user (font, size, theme, window placement),
      so not much technical.</p>
    <p>For us, Morphic is like breathing air, very common and basic. Is
      it the case for a  Cuis/Smalltalk neophyte? I think no. That's why
      I pushed it to the second part of the book. Nevertheless, the
      first part could write about Morphic, in the two application
      examples, but not exhaustively.<br>
    </p>
    <p>We should question our self, what is the target audience of the
      book? I was thinking about a reader with little or no experience
      in programming, but interested on the topic. It is important to
      decide on the typical reader for the book to get the content right
      for. Smalltalkers, coming or curious about Cuis, will likely have
      little benefit of the book; they are capable to figure out by
      themselves how to start and use fluently Cuis. The vast majority
      of prospective readers to seduce have zero knowledge about
      Smalltalk and Cuis. This gives some perspective.</p>
    <p>Hilaire</p>
    <p><br>
    </p>
    <div class="moz-cite-prefix">Le 06/07/2020 à 16:27, Juan Vuletich a
      écrit :<br>
    </div>
    <blockquote type="cite" cite="mid:5F0334EC.40700@jvuletich.org">I
      don't have a strong opinion on the best way to document Cuis. I
      think a book would be great addition to the Cuis world, and I'm
      willing to help. I also think that is the license of the contents
      is appropriate, stuff we write could be reused in other forms
      (like active essays in the image).<br>
      <br>
      WRT to the table of contents, I'd add a preface explaining what
      Cuis (and Smalltalk-80) is all about, and as little space on
      technicalities as possible. For instance, I don't think that
      "Configuring Cuis Smalltalk environment" is needed, and would
      collaps Installing... and Starting... in a single hopefully short
      text.<br>
      <br>
      I'd also avoid waiting until "advanced topics" to tell a bit about
      Morphic. The UI and the environment are central to Smalltalk, and
      Morphic is central to Cuis.<br>
    </blockquote>
    <pre class="moz-signature" cols="72">-- 
GNU Dr. Geo
<a class="moz-txt-link-freetext" href="http://drgeo.eu">http://drgeo.eu</a>
<a class="moz-txt-link-freetext" href="https://pouet.chapril.org/@hilaire">https://pouet.chapril.org/@hilaire</a></pre>
  </body>
</html>