Tutorial advice

Whether you're a newbie or an experienced programmer, any questions, help, or just talk of any language will be welcomed here.

Moderator: Coders of Rage

Post Reply
User avatar
Moosader
Game Developer
Game Developer
Posts: 1081
Joined: Wed May 07, 2008 12:29 am
Current Project: Find out at: http://www.youtube.com/coderrach
Favorite Gaming Platforms: PC, NES, SNES, PS2, PS1, DS, PSP, X360, WII
Programming Language of Choice: C++
Location: Kansas City
Contact:

Tutorial advice

Post by Moosader »

So I've slacked off the entire break, and now I intend to get some stuff done.

Besides everything else in my evil, overcrowded queue of things to work on (including other tutorials), I've started on basically a tutorial on How to Write Rawr Rinth.
I will eventually make videos for these once I write the entire page, but I want to be prepared this time for a big tutorial, instead of royally botching it like my Spring Break project.
I haven't really felt like recording myself lately, though. My voice is starting to get on my nerves, lol.

Anyway. This and all my future tutorials are to have their own pages, with text versions of the tutorial. I'm working on it right now, and I was wondering if it wasn't to-the-point enough. I'm trying not to ramble, but at the same time I'm writing this for an audience of people who probably don't know how to structure games yet, and need somewhere to begin.

Is what I have easy to follow? Is the page un-cluttered enough, or do I need more variety between spacing and formatting?
The more advice I get, the better I can make it for everyone else.

http://www.moosader.com/making-rawr.html

Not linked to in tutorials yet, just uploaded thus far for peer review.
User avatar
MarauderIIC
Respected Programmer
Respected Programmer
Posts: 3406
Joined: Sat Jul 10, 2004 3:05 pm
Location: Maryland, USA

Re: Tutorial advice

Post by MarauderIIC »

At least one header doesn't match its link (what do you need to know?). I think the font in the 'good newbie practice' box is too small -- personally, I prefer 'interruption boxes' styled like the ones in this post.

I'd make your headers larger in font size than other text, not just bold (or perhaps don't use the bold for headers at all). Perhaps use a stylesheet for H1 and H2 and so on.

'struct rectangle' should have the members indented, just to be safe =)

As for get/set, you might also mention other coding styles (I always name mine getVariableName() setVariableName() ), and also put the parameter in your void X() function -- I could see you getting questions about "I can't overload the return type!!" This might also be a good time to mention capitalization styles.

Run a spellchecker (habbit is misspelled).

General layout seems fine.
I realized the moment I fell into the fissure that the book would not be destroyed as I had planned.
User avatar
eatcomics
ES Beta Backer
ES Beta Backer
Posts: 2528
Joined: Sat Mar 08, 2008 7:52 pm
Location: Illinois

Re: Tutorial advice

Post by eatcomics »

Looks really good to me, very newbie friendly. I didn't spot any problems, but then again I don't look at details.... :lol: I think it looks really good and the fact that you add pictures and diagrams, and also different notes... with a cute little lusikka teacher character, make it look really good and interesting :)

Edit: I personally like the lusikka box better the other one is bland and boring....
although it may be a tad bit small as marauder mentioned
Image
User avatar
Moosader
Game Developer
Game Developer
Posts: 1081
Joined: Wed May 07, 2008 12:29 am
Current Project: Find out at: http://www.youtube.com/coderrach
Favorite Gaming Platforms: PC, NES, SNES, PS2, PS1, DS, PSP, X360, WII
Programming Language of Choice: C++
Location: Kansas City
Contact:

Re: Tutorial advice

Post by Moosader »

MarauderIIC wrote:
'struct rectangle' should have the members indented, just to be safe =)
i don't actually know how to indent in html
User avatar
MarauderIIC
Respected Programmer
Respected Programmer
Posts: 3406
Joined: Sat Jul 10, 2004 3:05 pm
Location: Maryland, USA

Re: Tutorial advice

Post by MarauderIIC »

I write &nbsp; a lot. <p> tags or <block> perhaps?
I realized the moment I fell into the fissure that the book would not be destroyed as I had planned.
Post Reply