<div dir="ltr"><div dir="ltr">Hi Hillaire!<div><br></div><div>I still have to finish reading TCB but even at this point, it is quite clear to me that it is a labour of love, and that you and the other authors are very conscious that it could be detrimental to include the kitchen sink.<br><br>I also think it could be a good candidate for a dynabook. I'd love to collaborate on that, even if I haven't finished all the exercises yet.<br><br>I am in no position to review TCB's content and extent yet. For the time being, it seems to me that it is good as it is.<br><br>Re. Wikis, any would do. During the last week, I've been testing different TiddlyWiki versions (some are better for multiple users) and I find that conceptually, TiddlyWiki shares with Smalltalk this idea of being self-contained, see <a href="https://www.youtube.com/watch?v=Uv1UfLPK7_Q">Intertwingling the Tiddlywiki with Erlang</a>. Nevertheless, I think that the ideal medium would be something that runs <b>in</b> Cuis and that at the same time could be rendered as a web site. Could Erudite do that?<br><br>Some topics:</div><div><ol><li>An in-depth customization guide</li><li>A tutorial for the simplest web application<br></li></ol><div>-- <br>Eze</div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">El mié, 2 ago 2023 a la(s) 12:02, Hilaire Fernandes via Cuis-dev (<a href="mailto:cuis-dev@lists.cuis.st">cuis-dev@lists.cuis.st</a>) escribió:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
  

    
  
  <div>
    <p>Hi Folks,</p>
    <p>Yeah again this boring topic of documenting... But for a
      community to grow you need some documentation. <br>
    </p>
    <p>From the feedback we regularly receive in the mailing list, we
      can say the <a href="https://cuis-smalltalk.github.io/TheCuisBook/" target="_blank">The Cuis
        Book</a> was and is a worthy effort. With Ken and Juan we
      discussed about the target audience, its contents and scope, and
      also its limitation. It does not present every facet of Cuis, it
      is a gentle introduction to basic programming, Smalltalk and Cuis,
      a sort of appetizer.</p>
    <p>I would like to discuss with you the next step in term of
      documentation. Indeed there are many topics we do not cover in
      detail or at all which could be useful to improve the experience
      of the developers. Among them Layout, VectorGraphics, GUI
      building, Event, Error handling, etc. <br>
    </p>
    <p>Nevertheless, there is already <a href="https://github.com/Cuis-Smalltalk/Learning-Cuis" target="_blank">Learning-Cuis</a>
      documentation, but I have doubt about github wiki for large
      documentation, may be I am wrong. There is also the embedded
      documentation from the Terse Guide. These useful documentations
      are in different places and formats, it does not ease the access
      to documentation. <br>
    </p>
    <p>We should get it all in one place: easy to access and to
      contribute too. Therefore as a medium we may want to use something
      flexible as a wiki or equivalent.<br>
    </p>
    <p>Regarding its content, we can discuss here the topics most of you
      will be interested by, after all this is the best way to have
      meaningful documentation. Also discussing how to structure the
      contents to prevent it to become too quickly a mess. Such contents
      will be a place of reference when a user needs some information or
      know how. In my opinion, such documentation is fundamental to see
      a growing Cuis community.<br>
    </p>
    <p>Concerning contributions, all users are concerned. Even a casual,
      new user of Cuis who has just finished reading the Cuis book could
      contribute. In fact, documenting a topic you are learning is an
      awesome mean for deeper learning. In education this is something
      we do often through learning by the pair.</p>
    <p>Let's the discussion begin :<br>
    </p>
    - Topics of interest
    <p>- Format, place  to document<br>
    </p>
    <p><br>
    </p>
    <p>Hilaire<br>
    </p>
  </div>

-- <br>
Cuis-dev mailing list<br>
<a href="mailto:Cuis-dev@lists.cuis.st" target="_blank">Cuis-dev@lists.cuis.st</a><br>
<a href="https://lists.cuis.st/mailman/listinfo/cuis-dev" rel="noreferrer" target="_blank">https://lists.cuis.st/mailman/listinfo/cuis-dev</a><br>
</blockquote></div></div>