View previous topic :: View next topic |
Author |
Message |
snoyberg
Joined: 17 Jan 2007 Posts: 10
|
Posted: Wed Jan 17, 2007 2:13 pm Post subject: D for Programmers |
|
|
Hi,
I've recently started using D, and while the current tutorial selection is great for finding examples of various features, it doesn't really do the job of an introduction to D for a total newbie (read: the tutorials didn't help me first get interested in D).
I think a tutorial aimed at programmers taking their first look at D would help the community a lot. I'm more than willing to write it, I just want to do it "properly" (whatever that means). Where would I start work on such a project?
Hope this can help,
Michael |
|
Back to top |
|
|
jcc7
Joined: 22 Feb 2004 Posts: 657 Location: Muskogee, OK, USA
|
Posted: Wed Jan 17, 2007 6:14 pm Post subject: Re: D for Programmers |
|
|
snoyberg wrote: | Hi,
I've recently started using D, and while the current tutorial selection is great for finding examples of various features, it doesn't really do the job of an introduction to D for a total newbie (read: the tutorials didn't help me first get interested in D).
I think a tutorial aimed at programmers taking their first look at D would help the community a lot. I'm more than willing to write it, I just want to do it "properly" (whatever that means). Where would I start work on such a project?
Hope this can help,
Michael |
You can start by adding new examples or by improving existing examples. If you've worked with a wiki before, the Trac wiki is similar to other wikis. If you don't have much experience with wikis, they're designed to be easy to use.
Recently, mmcdermo discussed his ideas of how to improve the tutorials in the D Learning Resources thread. I don't know if he's still planning on helping out, but as far as I know he hasn't done anything yet with the Tutorials project other than discussing his ideas. I liked his ideas, but I don't have the time required to put that kind of effort into the project. I tend to just fix the problems that I find out about and add a few examples here and there.
If you want to help out, there are several ways you could do that. One way would be to create an outline of what you think the Tutorial should teach that it doesn't already teach. Kind of like a "wish list".
If that doesn't sound like fun to you, another thing you could do is start by some adding examples. I've been accumulating links to possible examples over the years: Links To Example Code. Some of these "possible examples" are intended for an expert (not very useful to a true newbie). I'm sure some of that code will require some modification to get it to work with DMD 1.0. (By the way, I've also collected a bunch of newer links, if those are too stale for you.) I like to try the example and write a little explanation text about what is does before I save it as an example page, but you can decide how much effort you'd want to use for each example.
So it's really up to you. What do you want to do? Perhaps you just want to add a few examples to the Fundamentals page. Or maybe you want to create a new "total newbie" category where everything is explained in much more detail?
How does that sound? |
|
Back to top |
|
|
snoyberg
Joined: 17 Jan 2007 Posts: 10
|
Posted: Thu Jan 18, 2007 3:03 pm Post subject: Tutorial on Wikibooks |
|
|
Well, I started work on what I was talking about. It's currently at http://en.wikibooks.org/w/index.php?title=D_Transition_Guide (linked from the D for Beginners Wikibook).
I didn't want to just submit examples, because what I'm aiming for is a simple-to-follow guide to transition from C/C++/Java to D. I haven't added a lot of stuff, but you should get the idea from what's up there.
If you'd rather keep everything together in one place on the dsource tutorials, I'm happy to move it over, as long as I can keep it all together in a progression the way it is now. |
|
Back to top |
|
|
jcc7
Joined: 22 Feb 2004 Posts: 657 Location: Muskogee, OK, USA
|
Posted: Thu Jan 18, 2007 10:33 pm Post subject: Re: Tutorial on Wikibooks |
|
|
I added a link to this on the D Tutorial page at Wiki4D.
snoyberg wrote: | I didn't want to just submit examples, because what I'm aiming for is a simple-to-follow guide to transition from C/C++/Java to D. I haven't added a lot of stuff, but you should get the idea from what's up there. | Oh, I misunderstood. I thought you meant for a guide for someone who was new to programming in general. Oh, well, it'd be good to have a tutorial for ever potential audience anyway.
snoyberg wrote: | If you'd rather keep everything together in one place on the dsource tutorials, I'm happy to move it over, as long as I can keep it all together in a progression the way it is now. | As long as there are links between the projects, I don't think it matters so much where the actual content is located. What I really like about our Trac wiki at dsource is the D syntax highlighting, but if you prefer the MediaWiki style, you ought to leave your tutorial where it is. |
|
Back to top |
|
|
|
|
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum
|
Powered by phpBB © 2001, 2005 phpBB Group
|