Brand Spanking New Tutorials

Strictly for discussing ZSNES development and for submitting code. You can also join us on IRC at irc.libera.chat in #zsnes.
Please, no requests here.

Moderator: ZSNES Mods

Post Reply
undisbeliever
Rookie
Posts: 35
Joined: Sat Aug 21, 2004 2:31 am
Location: is an eight lettered word

Brand Spanking New Tutorials

Post by undisbeliever »

A while ago I received some emails saying how my tutorials were a bit hard to understand and going over them I could see why. They relied on previous assembly knowledge, referring to CPU core registers that I haven't even mentioned yet.

So, I've re-vamped the entire site (after discovering major security holes) and am now starting to re-write the SNES Tutorials (Starting from the top - The 65816 Core Registers).

Here they are: http://snescentral.edgeemu.com/snesrpg/?main=tut01asm

What do you guys think this rates as a SNES coding Tutorial? (Though I have seen other SNES tutorials and they seam to be snippets of the outdated SNES Documents strung together by occasional paragraph - no offence)

Eventually when this site gains popularity and information I should be able to start a SNES gaming project or 'The lone hacker' competition.
Nightcrawler
Romhacking God
Posts: 922
Joined: Wed Jul 28, 2004 11:27 pm
Contact:

Post by Nightcrawler »

Well... who is your target audience here? I think you're still throwing around many terms without giving much explanation and expecting the reader to have some base knowledge beforehand.

For example right from the beginning.., what IS a register? What IS a Mnemonic? What IS an OPcode? Then you jump right in to accumulators Right away, anybody new is going to get lost.

You continue to write like that throughout. Your document still looks to me to be geared toward somebody who already understands CPU architecture and some assembly terms already.

I really think it needs to be dumbed down some more with more time taken to explain each new term you're using. Also, an explanation of what things are used for would be nice.

What is a program and databank register used for? You don't really explain, you just throw out it contains the program or data address. Newbies don't even know the difference between program and data addresses or banks etc..

No offense, but I would not recommend your document to new comers. I WOULD recommend it to anybody who's had any previous assembly experience though as it's quite clear throughout if you already know the terminology that you're using.

I'm not trying to shoot your document down, I just honestly feel it's missing the target audience of newcomers if that is indeed what you're going for.
[url=http://transcorp.romhacking.net]TransCorp[/url] - Home of the Dual Orb 2, Cho Mahou Tairyku Wozz, and Emerald Dragon SFC/SNES translations.
[url=http://www.romhacking.net]ROMhacking.net[/url] - The central hub of the ROM hacking community.
pagefault
ZSNES Developer
ZSNES Developer
Posts: 812
Joined: Tue Aug 17, 2004 5:24 am
Location: In your garden

Post by pagefault »

This site is a very good idea. I would like it if you posted some tutorials on how people can write text to the screen and things of that matter. Maybe a hello world application. It would be interesting to see more people get into the rom hacking scene.
Nightcrawler
Romhacking God
Posts: 922
Joined: Wed Jul 28, 2004 11:27 pm
Contact:

Post by Nightcrawler »

pagefault wrote:This site is a very good idea. I would like it if you posted some tutorials on how people can write text to the screen and things of that matter. Maybe a hello world application. It would be interesting to see more people get into the rom hacking scene.
Have you heard about http://www.romhacking.net yet? We're assembling quit a good size portion of the community over there. 185 Documents, 290 Utilities and counting.

We've also got a 'Getting Started' section aimed directly at the newest of new to prepare them to utilize the majority of the main documents in the archive.
[url=http://transcorp.romhacking.net]TransCorp[/url] - Home of the Dual Orb 2, Cho Mahou Tairyku Wozz, and Emerald Dragon SFC/SNES translations.
[url=http://www.romhacking.net]ROMhacking.net[/url] - The central hub of the ROM hacking community.
undisbeliever
Rookie
Posts: 35
Joined: Sat Aug 21, 2004 2:31 am
Location: is an eight lettered word

Post by undisbeliever »

Code: Select all

Well... who is your target audience here? I think you're still throwing around many terms without giving much explanation and expecting the reader to have some base knowledge beforehand. 
Well this is the reason why I've scrapped my old tutorials and written some new ones, the real problem is not writing TOO much information to scare them off - but I get your point. Consider them re-written (or edited)
Post Reply