6502.org Forum  Projects  Code  Documents  Tools  Forum
It is currently Tue Jun 04, 2024 12:55 am

All times are UTC




Post new topic Reply to topic  [ 53 posts ]  Go to page 1, 2, 3, 4  Next
Author Message
PostPosted: Fri Jul 21, 2023 10:39 pm 
Offline

Joined: Sat Oct 09, 2021 11:21 am
Posts: 707
Location: Texas
Hello everyone!

I've been designing and coding for my Acolyte 6502 Computer for a while now (most recent topic on that here viewtopic.php?f=4&t=7407).

For as long as I've been designing it, I've had two goals in mind:

1) Use it for video games for Math Appreciation Day (most recent topic on that here viewtopic.php?f=1&t=7585).

2) Use it to help teach high school aged folks the basics of digital electronics. This is the reason for this new topic.

I find that the Ben Eater kits + videos are good, but ultimately I feel that breadboards should not be the final goal. I also feel that it lacks solid human input/output interfaces, particularly *useful* video, easy keyboard, and mass storage capabilities. Some of these are easy to get without Ben's personal help, some he has tried himself but fell short. [ These are my opinions, you can have your own opinions of course. ]

What other kits out there can give you the full home microcomputer experience, while still being understandable and yet useful? Ones that don't give you black box FPGA chips that run 100 times faster than the 6502, or try to hide some critical aspects behind epoxy blobs? What is designed not for experts but interested beginners, yet give them a long lasting product they can be proud of, and "own it" themselves? What is not $300 just to run BASIC?

I am proposing to use the Acolyte as a "solder it yourself" kit (or maybe also a pre-soldered kit?), certainly under $100, coming with a great user manual that doubles as a curriculum of sorts. Videos are also a possibility. And although I am a math teacher, I cannot make digital electronics curriculum to save my life it seems. I need someone who likes writing, someone who would partner with me to get something out there, and perhaps make some money while doing it. Is that person you?

Feel free to post here, or PM me if you'd rather do that. I'm happy to take suggestions as well, even critical.

Thank you everyone.

Chad


Top
 Profile  
Reply with quote  
PostPosted: Thu Jul 27, 2023 7:22 pm 
Offline

Joined: Sat Oct 09, 2021 11:21 am
Posts: 707
Location: Texas
It seems there is no interest in that regard. No problems, thank you for reading none-the-less.

Garth, I cannot delete topics, so if you as moderator want to delete this topic, then go ahead. Thank you all!

Chad


Top
 Profile  
Reply with quote  
PostPosted: Thu Jul 27, 2023 7:47 pm 
Offline

Joined: Mon Jan 19, 2004 12:49 pm
Posts: 702
Location: Potsdam, DE
I suspect the reason for lack of interest is that 'a bit of writing' is amazingly time consuming - I speak as one who has published a technical book (not in the micro field) and who has had to document complex systems in the past for major (country wide) projects.

Basically, it isn't easy... while the idea appeals, I would not wish to attempt it as I have far too much on my plate at the moment. It's amazing how busy you get once you retire...

I suspect also that people here would rather be working on their own projects - whether development or documentation - than on someone else's.

Neil


Top
 Profile  
Reply with quote  
PostPosted: Thu Jul 27, 2023 8:08 pm 
Offline

Joined: Fri May 05, 2017 9:27 pm
Posts: 864

Agreed. It's time consuming especially for someone, like me, who has no experience with technical writing. I suspect there are others here, like myself, busy with documenting their own projects and finding there is not enough time to pursue all the interesting technical ideas which spring to mind.
I would not recommend deleting this thread. You might get a response from someone who does have time. At the very least, someone may know of introductory electronics material free to incorporate into your curriculum.

Jim


Top
 Profile  
Reply with quote  
PostPosted: Thu Jul 27, 2023 8:08 pm 
Offline
User avatar

Joined: Wed Feb 14, 2018 2:33 pm
Posts: 1432
Location: Scotland
barnacle wrote:
I suspect the reason for lack of interest is that 'a bit of writing' is amazingly time consuming - I speak as one who has published a technical book (not in the micro field) and who has had to document complex systems in the past for major (country wide) projects.


My wife is a writer - of sorts - as a celebrant, she has the task of condensing a persons life-story from family meetings and chats into their story to be read out at their funeral and often she has less than a week to do it... It's a great skill, but would it work in a technical environment? I suspect not.

I have written many manuals and documentation in the past for some of my projects too - see

https://unicorn.drogon.net/apricot.pdf

for a recent example... but would I want to write a manual or documentation for someone elses project? Not really - sorry, but if you want the templates, Makefiles, etc. and can use LaTeX then let me know...

Videos - don't need to be hard - they just take time - I use OpenShot as an editor to put together stuff from mobile phone, GoPro and screen recorder.

However - I'd suggest keeping the thread alive and not deleting it - you never know, some people only pop in once a week or 2, so leaving it longer isn't going to hurt.

Good luck,

-Gordon

_________________
--
Gordon Henderson.
See my Ruby 6502 and 65816 SBC projects here: https://projects.drogon.net/ruby/


Top
 Profile  
Reply with quote  
PostPosted: Thu Jul 27, 2023 8:09 pm 
Offline

Joined: Sat Oct 09, 2021 11:21 am
Posts: 707
Location: Texas
Never meant to make it just my own project, if they were to partner. That's what partners do, right?

But I understand. If I never asked, I'd have to blame myself for never asking!

Thank you.

Chad


Top
 Profile  
Reply with quote  
PostPosted: Thu Jul 27, 2023 8:19 pm 
Offline
User avatar

Joined: Fri Aug 30, 2002 1:09 am
Posts: 8453
Location: Southern California
I do enjoy writing.  I probably enjoy it too much.  But as Neil says, it is extremely time-consuming to do a good job, the kind of thing that is normally only done if there's income from it, unless it is just a huge labor of love (which does happen frequently).

_________________
http://WilsonMinesCo.com/ lots of 6502 resources
The "second front page" is http://wilsonminesco.com/links.html .
What's an additional VIA among friends, anyhow?


Top
 Profile  
Reply with quote  
PostPosted: Thu Jul 27, 2023 10:02 pm 
Offline
User avatar

Joined: Thu May 28, 2009 9:46 pm
Posts: 8198
Location: Midwestern USA
Lots of technical writing under my belt (see attached for an example). That said, I look at documentation as work, not fun, and at my advanced age, I prefer to expend more of my dwindling time at play. :D

Attachment:
File comment: Thoroughbred Programming Cookbook
tbpcb.pdf [1.92 MiB]
Downloaded 84 times

_________________
x86?  We ain't got no x86.  We don't NEED no stinking x86!


Top
 Profile  
Reply with quote  
PostPosted: Fri Jul 28, 2023 5:45 am 
Offline

Joined: Mon Jan 19, 2004 12:49 pm
Posts: 702
Location: Potsdam, DE
One side point is the question of language. In spite of superficial resemblance, English English (such as I speak and write) is not the same as American English (such as I expect you, and of course your local readers, to speak and write). The differences are often subtle but will give the reader a sense of something being 'wrong' in the way something reads - particularly younger readers will expect a shared context with the writer and find it much easier to handle if it exists.

As an example: I have been learning German from a Duolingo course for a couple of years. A big problem for me is that Duolingo does not use UK English as a base language but rather US English, and the result is that apart from its preference for US spelling and grammar, there are whole chunks of context for which I have no referents - school and university life, for example. I have to translate German to English and English to American :D

Neil


Top
 Profile  
Reply with quote  
PostPosted: Fri Jul 28, 2023 8:32 am 
Offline

Joined: Fri Jul 09, 2021 10:12 pm
Posts: 741
I might be able to proofread and offer suggestions etc but I don't have any experience in education and due to some personal problems recently I can't really make any serious commitments, it is really unpredictable whether I'll have time to spend on anything hobbywise.


Top
 Profile  
Reply with quote  
PostPosted: Fri Jul 28, 2023 8:41 am 
Offline
User avatar

Joined: Fri Aug 30, 2002 1:09 am
Posts: 8453
Location: Southern California
Neil, what differences have you noticed in written British versus US English, besides spellings?  Webster, originator of Webster's dictionary, simplified some of our spellings some 250 years ago IIRC, like "plough"-->"plow," "colour"-->"color," etc..  I wish he had gone a lot further.  I read a book to our kids when they were young that had British English in it, and would change some of the words on the fly to be more understandable and natural to them.  It was not technical though, and it has been so many years that now I would have to find it and review to remember what differences there were.  I wonder what UK readers see as different, languagewise, when they read articles on my website.

_________________
http://WilsonMinesCo.com/ lots of 6502 resources
The "second front page" is http://wilsonminesco.com/links.html .
What's an additional VIA among friends, anyhow?


Top
 Profile  
Reply with quote  
PostPosted: Fri Jul 28, 2023 1:10 pm 
Offline

Joined: Sat Oct 09, 2021 11:21 am
Posts: 707
Location: Texas
Since this topic is more populated, I suppose I could pitch in.

First, thank you Gordon and BDD for those examples. And thank you George for the offer.

Am I seeing it right that those examples are primarily software technical manuals? I do feel I could make a software manual, especially if its concerning software that I myself wrote. I don't think technical manuals on software need to be long and unwieldy, but need to get each function and a few examples in there. Whatever I would do software wise (assembly monitors and BASIC essentially) would be so small I typically fit a "help menu" within 1KB of characters on the ROM itself to display on the screen directly.

And, likewise, I feel that technical manuals on hardware don't need to be super long either. A few flowcharts, timing diagrams, and of course the schematics. Often I put a good deal of "idea" and "flow" as silkscreen on the boards themselves, especially when I have extra room.

But that's my dilemma. I can fit my technical understands and logic for both hardware and software on silkscreen and ROM. This is hardly "curriculum"! That's my bigger hangup. I'm wanting to develop some type of... school book, essentially. Much closer to Garth's website than anything else I've seen. [ And why don't I just let Garth's website be sufficient for this purpose? Good question. ]

And where to start? Would a curriculum start with "this is what electricity is"? Or would it start with "this is binary logic"? Or would it start with Garth's "you need to know what OR-wired means"? If you start from zero, heck, you probably aught to teach the reader basic addition and subtraction!

As a math teacher, I find that how I teach math is primarily giving examples, and then having them repeat on their own or with guidance. My idea of "curriculum" is not a lot of blah blah, but tons of examples, show new concepts with even more examples, then do more examples for practice, etc. Is that how it would be here too?

Thank you everyone.

Chad


Top
 Profile  
Reply with quote  
PostPosted: Fri Jul 28, 2023 2:56 pm 
Offline

Joined: Mon Jan 19, 2004 12:49 pm
Posts: 702
Location: Potsdam, DE
GARTHWILSON wrote:
Neil, what differences have you noticed in written British versus US English, besides spellings?  Webster, <...> I wonder what UK readers see as different, languagewise, when they read articles on my website.


Aye Garth, I could rant for hours so probably best that I don't, but I'll point out that the differences are sufficient that every major printing house I know of maintain separate UK and US editors for books which are to be released in both countries.

In short, Noah Webster's spelling changes are obvious and grating to a UK reader's eye; grammar and punctuation changes are much more subtle but still enough occasionally to trip a reader up - particularly where 'woke' prose re-uses existing words with a new meaning - and perhaps most obvious is cultural and social references. That applies both to replacement words (to me, a pavement runs along the side of the road, and isn't the road surface itself; I go to a shopping centre, not a mall) and to context: if you haven't been through the US school or university system, referents there are completely missing. c.f. words which Can Never Be Said, and people who don't know the difference between Those Words and other unrelated words that just sound similar (didn't someone in government get 'resigned' a few years back for correctly using the word 'niggardly' (grudging and petty in giving or spending.))

I accept I may be an outlier: my father was something of a grammar evangelist, and I'm sure I've picked up his habits. And my Master's dissertation was on how to ensure words that don't exist are correctly spelt (!). It's likely that younger people may not immediately notice the difference but it did strike me as something that might be worth considering: write the book to the target audience.

Neil


Top
 Profile  
Reply with quote  
PostPosted: Fri Jul 28, 2023 4:20 pm 
Offline

Joined: Fri Mar 18, 2022 6:33 pm
Posts: 454
barnacle wrote:
my Master's dissertation was on how to ensure words that don't exist are correctly spelt (!).
Spelt is a grain.

(U.S. reader / writer over here! Did you do that on purpose?) :D

_________________
"The key is not to let the hardware sense any fear." - Radical Brad


Top
 Profile  
Reply with quote  
PostPosted: Fri Jul 28, 2023 5:53 pm 
Offline
User avatar

Joined: Wed Feb 14, 2018 2:33 pm
Posts: 1432
Location: Scotland
barnacle wrote:
I accept I may be an outlier: my father was something of a grammar evangelist, and I'm sure I've picked up his habits. And my Master's dissertation was on how to ensure words that don't exist are correctly spelt (!). It's likely that younger people may not immediately notice the difference but it did strike me as something that might be worth considering: write the book to the target audience.

Neil


Maybe not the only one... I spent 3 years living & working in the US - both coasts, so got to experience dialect differences too.

But I'm Scottish, even though I've lived about half my life outside Scotland I'm back in Scotland again where it seems that we're "reclaiming" oor langwidge and dialect again. An why no?

Oh how we laughed back in '78 when the first Apple IIs came over with their color graphics and catalog of discs ... Very quickly turned into groans but there you go - 2 nations separated by a common language, as it were...

-Gordon

_________________
--
Gordon Henderson.
See my Ruby 6502 and 65816 SBC projects here: https://projects.drogon.net/ruby/


Top
 Profile  
Reply with quote  
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 53 posts ]  Go to page 1, 2, 3, 4  Next

All times are UTC


Who is online

Users browsing this forum: No registered users and 8 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to: