Java-Gaming.org Hi !
Featured games (90)
games approved by the League of Dukes
Games in Showcase (739)
Games in Android Showcase (224)
games submitted by our members
Games in WIP (820)
games currently in development
News: Read the Java Gaming Resources, or peek at the official Java tutorials
 
    Home     Help   Search   Login   Register   
Pages: [1]
  ignore  |  Print  
  advice on creating useful tutorials  (Read 1102 times)
0 Members and 1 Guest are viewing this topic.
Offline rolen

Senior Newbie


Medals: 1



« Posted 2017-09-05 22:34:23 »

i have some experience developing games and have my own game framework ported to at least 5 programming languages (java included).

i want to pass my knowledge in an effective and fast way (so i can produce more content in less time).

i think video tutorials with a combo of tutorial articles will be effective (plus github).

the problem is that i didnt find any resource teaching how to do it effectively ("how to create programming tut"). so im stuck with a slow and probably noneffective creation process .

i know there are people who can create a few minutes video tut very fast. and in a way people will like it.

i do my video and audio editing, i also record the screen and write my script (its hard for me to talk and code at the same time).

i think my voice is monotone and that not alot of people will understand my explanations . also the process is slow.

if anyone has any advice on how to improve all of that it will be great.
 
what do you think is better screen shot slides or screen recording? screen recording is heavier and harder to edit and convert.
do people want to see me type everything or would they prefer a code walkthrough?
one thing i already know is that you need to show people the end result at the start and give a brief preview on what you will be teaching.
Offline KevinWorkman

« JGO Plugged Duke »


Medals: 265
Projects: 12
Exp: 12 years


HappyCoding.io - Coding Tutorials!


« Reply #1 - Posted 2017-09-06 00:59:23 »

You didn't find a "how to create tutorials" tutorial because there isn't one single way to do it. Different teachers teach with different styles, and different students learn with different styles.

Like many things in programming, the best advice I can give you is: practice makes perfect. Your content, and your ability to create that content, will get better with time.

I've been putting together tutorials for a few years now, and I still find it a pretty slow and tedious process. The best advice I can give you (which is the same advice I give to people asking how to program) is to work in small, shippable chunks. What is the smallest thing you can create a tutorial for? Do that. Get that out the door and published before you start creating the next one. This is especially difficult for "series tutorials" where you're constantly rearranging how things should fit together. But again, practice makes perfect.

You also might be curious to check out a very new Stack Exchange site called Computer Science Educators.

HappyCoding.io - Coding Tutorials!
Happy Coding forum - Come say hello!
Offline rolen

Senior Newbie


Medals: 1



« Reply #2 - Posted 2017-09-21 21:43:47 »

i will chack that stack exchange.

also i realy liked your website and tutorials. i might create one myself.

not getting easier you say. i had a feeling that is the case. im not very good at it now i hope i will get better and be able to create tutorials faster.

i already created a small tool to help me generate html code for tutorials, that shod make the written ones be made faster.

thank you your website is an inspiration.
Games published by our own members! Check 'em out!
Legends of Yore - The Casual Retro Roguelike
Offline KevinWorkman

« JGO Plugged Duke »


Medals: 265
Projects: 12
Exp: 12 years


HappyCoding.io - Coding Tutorials!


« Reply #3 - Posted 2017-09-22 01:31:26 »

i already created a small tool to help me generate html code for tutorials, that shod make the written ones be made faster.

Have you heard of Jekyll? It allows you to write in markdown that then gets converted to HTML. Works seamlessly with GitHub Pages. That's what I use.

thank you your website is an inspiration.

Aw shucks. That's nice to hear.  Grin

HappyCoding.io - Coding Tutorials!
Happy Coding forum - Come say hello!
Offline rolen

Senior Newbie


Medals: 1



« Reply #4 - Posted 2017-09-22 22:00:07 »

yes i have but as a web developer i write my own code so i didnt see where it will be useful for me or my clients.
i see potential in github pages, but never figured how to use it , or seen a need i use web servers and wordpress for clients.

i would of never have guessed your site was made with  Jekyll+github pages.

now im going to look into it and learn how to use those tools. i thoght you have a server and domain (and was wondering if you pay 50$ every two years for it).

very nice thank you.
Offline KevinWorkman

« JGO Plugged Duke »


Medals: 265
Projects: 12
Exp: 12 years


HappyCoding.io - Coding Tutorials!


« Reply #5 - Posted 2017-09-23 03:34:36 »

yes i have but as a web developer i write my own code so i didnt see where it will be useful for me or my clients.

Well, different tools for different jobs. Jekyll is super useful for what I do. Wordpress would be overkill for what I need, plus I just don't like using it. Who are your clients?

i would of never have guessed your site was made with  Jekyll+github pages.

Can I ask why not? GitHub pages is basically just a webhost. Jekyll is basically just a template engine and markdown parser.

I write the tutorials in markdown. I write the rest of the site in plain old HTML and JavaScript. I use Jekyll to tie it all together and output the final html files, and I use GitHub pages for hosting.

now im going to look into it and learn how to use those tools. i thoght you have a server and domain (and was wondering if you pay 50$ every two years for it).

I have a domain, I think it costs like 10 bucks a year. I don't need a server, just a webhost.

HappyCoding.io - Coding Tutorials!
Happy Coding forum - Come say hello!
Offline rolen

Senior Newbie


Medals: 1



« Reply #6 - Posted 2017-09-24 14:12:15 »

current clients? some guy that needs theme translation passed to child theme and someone that want ads from one website to run on all his websites, one is new the other is return client. and i still dont make a living off it. dont have more then 5 projects a year.

wordpress for a programmer? too slow . its good your using tools like Jekyll and html css js.


GitHub pages = free hosting (for static website).nice.

where did you get a domain for 10$ ? the min i found on google(for .io) is 35$ for two years. a 10$ domain a year will be a huge help in creating a tut website.
Offline Gornova
« Reply #7 - Posted 2017-09-25 19:15:09 »

where did you get a domain for 10$ ? the min i found on google(for .io) is 35$ for two years. a 10$ domain a year will be a huge help in creating a tut website.

try https://www.namecheap.com for that

Blog | Last game A droid story
Offline rolen

Senior Newbie


Medals: 1



« Reply #8 - Posted 2017-09-25 19:30:09 »


nice thanks
Offline KevinWorkman

« JGO Plugged Duke »


Medals: 265
Projects: 12
Exp: 12 years


HappyCoding.io - Coding Tutorials!


« Reply #9 - Posted 2017-09-26 01:55:08 »

where did you get a domain for 10$ ?

Yeah I just used namecheap. Also note that with GitHub Pages you get a free subdomain like:

YourWebsiteName.github.io

If 35 bucks for 2 years is out of your price range, you should really consider the free alternatives. You can always change it later.

HappyCoding.io - Coding Tutorials!
Happy Coding forum - Come say hello!
Games published by our own members! Check 'em out!
Legends of Yore - The Casual Retro Roguelike
Offline rolen

Senior Newbie


Medals: 1



« Reply #10 - Posted 2017-10-02 23:41:34 »

i have created a tool (softwere) to help me create and edit html files faster, i may turn it into a full website maker in the future. but its very helpful as it is.

https://github.com/yoel123/yoel-java-tut-maker-helper-softwere
Offline CommanderKeith
« Reply #11 - Posted 2017-10-03 12:28:44 »

https://www.namesilo.com/index.php
Also very cheap

Pages: [1]
  ignore  |  Print  
 
 

 
Ecumene (54 views)
2017-09-30 02:57:34

theagentd (77 views)
2017-09-26 18:23:31

cybrmynd (185 views)
2017-08-02 12:28:51

cybrmynd (183 views)
2017-08-02 12:19:43

cybrmynd (190 views)
2017-08-02 12:18:09

Sralse (200 views)
2017-07-25 17:13:48

Archive (756 views)
2017-04-27 17:45:51

buddyBro (890 views)
2017-04-05 03:38:00

CopyableCougar4 (1439 views)
2017-03-24 15:39:42

theagentd (1322 views)
2017-03-24 15:32:08
List of Learning Resources
by elect
2017-03-13 14:05:44

List of Learning Resources
by elect
2017-03-13 14:04:45

SF/X Libraries
by philfrei
2017-03-02 08:45:19

SF/X Libraries
by philfrei
2017-03-02 08:44:05

SF/X Libraries
by SkyAphid
2017-03-02 06:38:56

SF/X Libraries
by SkyAphid
2017-03-02 06:38:32

SF/X Libraries
by SkyAphid
2017-03-02 06:38:05

SF/X Libraries
by SkyAphid
2017-03-02 06:37:51
java-gaming.org is not responsible for the content posted by its members, including references to external websites, and other references that may or may not have a relation with our primarily gaming and game production oriented community. inquiries and complaints can be sent via email to the info‑account of the company managing the website of java‑gaming.org
Powered by MySQL Powered by PHP Powered by SMF 1.1.18 | SMF © 2013, Simple Machines | Managed by Enhanced Four Valid XHTML 1.0! Valid CSS!