[Cuis-dev] On the importance of Documentation ! Even tiny one.

ken.dickey at whidbey.com ken.dickey at whidbey.com
Sun May 18 08:27:11 PDT 2025


On 2025-05-18 04:26, Eric Sessoms via Cuis-dev wrote:
> On Sun, May 18, 2025, at 4:29 AM, Hilaire Fernandes via Cuis-dev wrote:
>> Hannes and I spend several hours thinking how to design a 
>> documentation
>> system for the benefit of Cuis. It is in place, it is easy to navigate
>> in, it is easy to contribute, it is easy to write down incomplete 
>> notes.
>> There is no excuse.
> 
> Um... _how_?
> 
> Yes, I am one of the 200 lurkers you called out in your "Time to give
> back!" message a couple of months ago.  Guilty as charged.  But at the
> risk of sounding like a troll, I can't find any documentation on how
> to contribute to the documentation.
...
> I'm left wondering:  Will there be a wiki?  Where?  Should I
> preemptively ask to be added to the repositories?  The organization?
> Do you want pull-requests?  Issues?  The fact that I don't know how
> I'm expected to contribute is a barrier to getting started.
> 
> Maybe you have already addressed all these questions and I'm just
> blind or an idiot (can never rule that one out) but I'm unable to find
> the answers.

Eric,

Thanks for showing up and posing interesting questions.

We all suffer from busy lives.  It is very useful to get all the help we 
can to share what we know and how to discover what we don't.

Another consideration is to refer to, if not combine, the multitude of 
ways people are attempting to address this situation.

If you look at
   https://github.com/DrCuis/Learning-Cuis/blob/master/README.md

You will note references to work of Dr Nicola Mingotti and Mark 
Volkmann.  We also have Cuis-doc-in-Cuis tools, Class Comments, Package 
Installer, an so forth.

As the Cuis Community grows, just making sense of this to channel people 
of different backgrounds and expectations into useful, orienting, and 
productive learning is a challenge.

I look forward to thoughtful suggestions.

Please lurk more loudly!  8^)
-KenD


More information about the Cuis-dev mailing list