Re: [stella] Stella Programmer's Guide Overhaul Project

Subject: Re: [stella] Stella Programmer's Guide Overhaul Project
From: Erik Mooney <emooney@xxxxxxxxxxxxxxxx>
Date: Mon, 15 May 2000 10:23:33 -0400
> Allow me to introduce myself.  My name is Chad Hendrickson.  I live in Hoffman Estates, IL.  I spent my childhood in the '80s where my parents bought my brothers and I an Atari 2600 for Christmas in 1980.  Of course, I was hooked, playing such classics as Adventure, Combat, Missile Command, and Kaboom.  A few years later, I got an Atari 800 computer and eventually ran a BBS called The Dark Side of the Moon between 1985 and 1989.  The Atari 800 was upgraded to a 130XE somewhere along the way.  I also bought the Atari Mega ST2 around 1989.

You too, tell your email program to stop sending looooong lines of text :)
Also tell it to stop sending your messages as HTML.

> So far, I have gone though the guide that I got from the Atari
> Documentation Depot (http://members.xoom.com/atari_docs/) and have
> been slightly cleaning it up using the suggestions given on that page.  
> I also have spell checked it, reformatted it a bit, and fleshed it out
> a bit.  I also wouldn't mind taking on the role of maintaining the
> document and hosting it on my web site.  I want to make this the
> ultimate and most complete reference document for the Atari 2600.
> 
> I have a few questions:
> 
> 1)  Is this a good idea?

Having another document available certainly can't hurt, and your
converting it from a badly scanned bitmap to real text is certainly
helpful.  That said, though, this document is written from a technical
documentation standpoint, not really a "how to program" viewpoint.  And I
think we're already covering most of this ground in the developing FAQ.  
I think you'd be better off putting your resources into a great FAQ,
rather than trying to update a document that doesn't really need it.  

Well... Shout out to the guys who'd be using this stuff (hi Pete Holland)
- would you rather see this guide expanded, or a concentration on making
the FAQ comprehensive?

> 5)  What would be the best (most universal)
> format for the document?  Right now I am using Microsoft Word 97.

The most universal format is of course simple plain text.  Unfortunately,
that loses all the diagrams in the document - in particular, the "TV
Picture HERE" diagram really helped me when I was starting.  I'd suggest
making both Word 97 and .PDF versions available, if possible.  (I can
convert Word to PDF if you can't.)


--
Archives (includes files) at http://www.biglist.com/lists/stella/archives/
Unsub & more at http://www.biglist.com/lists/stella/

Current Thread