[Coco] Online BASIC documentation project idea.

James Ross jrosslist at outlook.com
Thu Mar 12 13:56:39 EDT 2020


> Allen Huffman wrote:
>> I am thinking about creating an online BASIC manual ... <snip>
>> I would like to make this its own wiki, independent of my www.CoCopedia.com project. 
>> Any objections?

Lee wrote:
> I'd love to see it eventually extend to more than
> BASIC.  Basic09, C, Assembly, Graphics, other hardware (ports/IO, etc),
> NitrOS9, ...  

IMHO, you should use GitHub instead of a wiki. You can use Markdown in *.md files which means creating the content is every bit as easy as a Wiki. However, with the advantage that collaborating (again IMO) is easier to track, maintain, and organize than a Wiki + the *.md files can be further processed for an official site and/or creating documents such as PDFs.

However, there is a fairly steep learning curve to picking up on Git and GitHub – that is the only downside :(.  

I’ve started something similar. A “sample code” GitHub site. I had not planned on making a public announcement of the project until I had many more samples and the structure fully ironed out. I would eventually like to see hundreds and hundreds of samples w/ descriptions along w/ reference materials / articles / tutorials. My problem is TIME! I just don’t have the time to devote to this project right now. However, I will throw it out there and see what people think, perhaps it ties in Allen’s idea.

https://github.com/CoCo3-org/CoCoSamples

The only project I could justify spending much time on right now, that is CoCo related, would be an idea for a CoCo Database w/ multiple client apps (Website, iPhone, Android, Windows, Mac) since that ties into what I am doing for my real work. (an apps code generator)

A while back (a couple years ago?) I registered the CoCo3.org domain

http://coco3.org/  

So far I have not done anything with it. I created the https://github.com/CoCo3-org account to match the Website / domain. Even though I want to remain the owner of these for the time being I am willing to add multiple administrators and at some point turn over ownership to the community in some “official” way.  

-jr


More information about the Coco mailing list