dtutor.org: a call to action

Nathan M. Swan nathanmswan at gmail.com
Sun May 5 15:08:58 PDT 2013


On Sunday, 5 May 2013 at 22:06:17 UTC, Nathan M. Swan wrote:
> On Sunday, 5 May 2013 at 19:37:02 UTC, Tyro[17] wrote:
>> The main contributors of D are doing a wonderful job of 
>> enhancing the
>> language. I can confidently say that we are leagues ahead of 
>> where we
>> stood a just two years ago. But there has been a long cry for
>> documentation that has gone unanswered: not because they 
>> refuse to
>> cooperate but rather, because they are a small volunteer 
>> force, occupied
>> by real demands to address the quirks of the language, and 
>> lack the time
>> to all issues by themselves.
>
> Don't we all :(
>
>>
>> It stands then that the community can make a conscious effort 
>> to address
>> some of the outstanding issues. As such, I have chosen to 
>> champion the
>> tutorial/documentation effort. Though, I possess very little 
>> programming
>> experience but am willing to try and am hereby soliciting your
>> assistance in making this a reality.
>
> Good luck!
>
>>
>> dtutor.org is an active domain dedicated to providing 
>> tutorials for the
>> language. I will require content contributors but before we 
>> can begin to
>> provide content there are a couple of issues to address:
>>
>> I. Features to be supported
>>
>>    Interactive Tutorials - Users must be able to modify and 
>> execute
>> examples in place to observe side effects.
>
> You have DPaste to work with here (http://dpaste.dzfl.pl/), 
> IIRC it is connected to sample code at dlang.org.
>
>>
>>    Interactive Books - A number of free books exist around the 
>> internet
>> that can be ported to D. The first two that come to mind are 
>> How to
>> "Think Like a Computer Scientist", "Problem Solving with 
>> Algorithms and
>> Data Structures Using Python" and Ali Çehreli's very own 
>> "Programming in D".
>
> Videos are useful as well.
>
>>
>>    Problems - Staged ICPC problems for users to attempt. 
>> Solutions may
>> be submitted online for comparison against previously submitted
>> solutions to determine efficiency ranking and users may choose 
>> to create
>> and account to keep track of progress.
>>
>>    Online Judge - to be used to determine accuracy and 
>> efficiency of
>> submitted solutions to problems and planned programming 
>> contests.
>
> I've had good experiences learning via stuff like that.
>
>>
>>    Forum - Unlocked to individual users per problem after 
>> solution
>> accepted by Online Judge.
>
> Rejected Software (creators of vibe) has vibenews, which I 
> believe is quite customizable.
>
>>
>> II. Look and Feel
>>
>> Look and feel of the site will be largely influenced by two 
>> things: The
>> DConf website and this little gem which provides encouragement 
>> for the
>> ideas behind interactive tutorials/books:
>>
>> 	Runestone (https://github.com/bnmnetp/runestone);
>>
>> I came across it while searching for ideas on how to get 
>> started with
>> dtutor.org and must admit: it is a fascinating little project.
>>
>
> It is!
>
> I have to vouch for cplusplus.com, which isn't interactive, but 
> I was able to teach myself C++ with only that and "C++ for 
> Dummies," so it worked for one guy.
>
>> I am wondering if there are any Python experts (or experts in 
>> general)
>> out there willing to assist in porting it to D? It comes with 
>> built in
>> support for Python and C/C++ among other languages. However, 
>> because
>> dtutor.org aims to promote all things D, it would aid greatly 
>> to have a
>> D implementation which removes all external dependencies and 
>> support
>> vice implementing D support for the original project. By doing 
>> this we
>> can showcase the strengths of DMDScript, vibe and other 
>> technology
>> already available in D.
>>
>> Logo: My idea for the logo is simply this (see attachment):
>>
>> 	D!(tutor).org
>
> If your target audience is people who know little about D, this 
> would just look odd.
>
>>
>> As Andrei would say: destroy!
>>
>> III. Constraints
>>
>> DMDScript for web scripting
>> Vibe for hosting (diet templates)
>> MangoDB for database
>>
>> IV. Timeline
>>
>> The hope is for complete functionality by DConf 2014.
>> Shooting for Initial Launch by September.
>>
>> Calling all website designers, database developers, authors 
>> and D
>> enthusiast. Lend a hand in eliminating this problem.
>
> Like everyone, my time is limited, but I can help a bit. Sign 
> me up!
>
>>
>> Andrew
>
> NMS

I forgot, do you have a github repo up?

NMS


More information about the Digitalmars-d mailing list