Page 1 of 1

Tutorial advice

Posted: Mon Jan 05, 2009 11:51 pm
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.

Re: Tutorial advice

Posted: Tue Jan 06, 2009 1:34 pm
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.

Re: Tutorial advice

Posted: Tue Jan 06, 2009 1:36 pm
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

Re: Tutorial advice

Posted: Wed Jan 07, 2009 1:07 pm
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

Re: Tutorial advice

Posted: Wed Jan 07, 2009 3:10 pm
by MarauderIIC
I write &nbsp; a lot. <p> tags or <block> perhaps?