Most important documentation?

Post your own tutorials, guides and demos.

Post » Wed Nov 28, 2007 2:26 am

??? So you suggest that they add to the learn-area a way of making a 3D first person shooter, with a program that doesn't even support 3D? Is that your word of advice?
B
8
S
2
G
5
Posts: 744
Reputation: 3,288

Post » Tue Sep 09, 2008 1:48 pm

I disagree completely with the general sentiment in this thread. I don't think the most important documentation is tutorials. While tutorials are great to start with, they are useless if people don't learn the basics. If all you have are tutorials, then users won't know how to make their own games, because they won't understand why the tutorials work. I think the basics on how all the features and functions work, and what you can do with them should be the priority. But that's just me.
B
1
G
4
Posts: 7
Reputation: 1,039

Post » Tue Sep 09, 2008 2:41 pm

[quote="zikzak23":1g8f8sca]If all you have are tutorials, then users won't know how to make their own games, because they won't understand why the tutorials work.[/quote:1g8f8sca]

That all depends on how you write your tutorial.
Moderator
B
5
S
2
G
6
Posts: 4,348
Reputation: 10,971

Post » Wed Sep 10, 2008 8:43 am

[quote="deadeye":1wpfh0nz]That all depends on how you write your tutorial.[/quote:1wpfh0nz]

That's true, but with a tutorial, all you know how to do is whatever is described in the tutorial. What if I want to do something there isn't a tutorial or example for? For example, it took me almost a week of wrestling with the Card Game Object before I gave up and asked in the forum, and found out it's not finished. Had there been documentation that said it wasn't finished, that would have saved me a lot of time. I think it's all in how you learn. Personally, the first thing I looked for was a detailed manual on all the features and functions of Construct, and was disappointed to find there isn't one yet. As nice as the tutorials are, I would prefer to know what everything does and what can be done with it. And I don't think sifting through all the threads and comments in the forum is a replacement for that.
B
1
G
4
Posts: 7
Reputation: 1,039

Post » Wed Sep 10, 2008 12:11 pm

The Construct Wiki has partial documentation. It's a work in progress and a lot of it is subject to change. I do also appreciate how important a reference is for documentation purposes, but I think tutorials are important to help get beginners going. We should have both!

Part of the problem is with so many plugins there is a lot of reference documentation to write. We need everyone's help to write it (it's an easy way to contribute to the project if you're not a programmer).
Scirra Founder
B
359
S
214
G
72
Posts: 22,952
Reputation: 178,600

Post » Wed Sep 10, 2008 4:26 pm

[quote="Ashley":3sx6x6sd]Part of the problem is with so many plugins there is a lot of reference documentation to write. We need everyone's help to write it (it's an easy way to contribute to the project if you're not a programmer).[/quote:3sx6x6sd]

I would love to help. I've already started on an Animator Bar article. When do I get edit access?
B
1
G
4
Posts: 7
Reputation: 1,039

Post » Wed Sep 10, 2008 7:11 pm

[quote="zikzak23":19p4ew0f]When do I get edit access?[/quote:19p4ew0f]
Potentially stupid question, but have you signed up on the wiki yet? The way I understand the process, you create the user, and then the admins give it edit permissions; but they can't (or won't) open the wiki account for you.
B
2
S
1
G
4
Posts: 60
Reputation: 1,320

Post » Thu Sep 11, 2008 9:06 am

I recently moved, when I get the internet installed again I'll try and sort out everyone's wiki access.
Scirra Founder
B
359
S
214
G
72
Posts: 22,952
Reputation: 178,600

Post » Thu Sep 11, 2008 9:58 am

It's currently not doable, due to MediaWiki being kinda hard to do permissions with.

There's only 3 classes, unregistered, registered and sysop. We need to create a new class for editors, because handing out sysop access to everyone is a bad idea :).

Will look into it today.
B
3
S
2
G
5
Posts: 1,777
Reputation: 5,529

Post » Fri Nov 14, 2008 9:36 am

I agree with zikzak; tutorials are useful, but the ones that already exist help get the basics out of the way and what is now needed is more information on all the undocumented objects, effects and behaviours.
I've only just discovered Construct, and looked at all the examples that were available to download and also the templates. So with that knowledge I tried to start my own game from scratch, and was disappointed to find that only a handful of objects had any sort of wiki entry ... and even then the entries that did exist didn't really explain the functionality and events available for that object.

At the moment if I want to use an effect I just guess at what it does, based on the name, and try it out. Most of the time I can't see any effect happening, which probably means I am using it wrong but without docs to explain how it should be used it is very much a case of stumbling along in the dark!

Anyway, I have got a simple game working and have now reached a stumbling block in terms of trying to find a way to display the high scores that I've been storing on a webserver. I'm sure I'll get there in the end.

All that aside, congrats for what you've got with Construct and I do appreciate the work people have put in.
B
1
G
4
Posts: 2
Reputation: 1,029

PreviousNext

Return to Your tutorials & example files

Who is online

Users browsing this forum: No registered users and 1 guest