On Mon, 07 Oct 2013 21:18:38 +0200, qznc wrote:

> I believe one of the things D needs right now is more documentation. Therefore, I started writing a tutorial.
> 
> It is aimed at people who can already program well in other languages. This means nothing about loops or structs, because I expect most people to know this stuff. I do not consider D to be a language for beginners anyways.
> 
> It is aiming for pragmatic not comprehensive advice. For example, I mostly ignore LDC and GDC except for the optimization chapter.
> 
> Since I am working on Linux exclusively and I like the command line, I cannot teach to Windows users. Sorry.
> 
> This is still very incomplete and my our newborn family member requires quite some attention. So expect this to develop with glacial speed. ;)
> 
> Nevertheless, I want to put this version 0.1 out to get some feedback. What do you think about the topic selection? What topics are missing? Serious errors so far?
> 
> http://beza1e1.tuxen.de/d-tut-0.1/index.html
> 
> Wreck it! :)

It is a very nice web-site, but the main column should be wider. Sometimes the source code floats over to the second column...

On Wednesday, 9 October 2013 at 20:22:39 UTC, Dejan Lekic wrote:
> It is a very nice web-site, but the main column should be wider.
> Sometimes the source code floats over to the second column...

Hm, not here. I suspect a weird font selection for the code.

I plan to redesign it at some point anyways. This is the agogo standard theme of Sphinx, which is the only standard theme, where the width is not 100%.

On Monday, 7 October 2013 at 22:39:26 UTC, qznc wrote:
> On Monday, 7 October 2013 at 20:36:46 UTC, Andrei Alexandrescu
>> OP: any chance to adjust that page? Then we'll announce to reddit.
>
> Too early for more publicity, I think.

Now every chapter has "some" text. Feel free to publicize it.

On 10/12/13 4:34 PM, qznc wrote:
> On Monday, 7 October 2013 at 22:39:26 UTC, qznc wrote:
>> On Monday, 7 October 2013 at 20:36:46 UTC, Andrei Alexandrescu
>>> OP: any chance to adjust that page? Then we'll announce to reddit.
>>
>> Too early for more publicity, I think.
>
> Now every chapter has "some" text. Feel free to publicize it.

Terrific, thanks! I assume the link is http://qznc.github.io/d-tut/.

Feel free to polish it through the weekend, I'll publish it on Monday at 9 AM PST.


Thanks,

Andrei

On Saturday, 12 October 2013 at 23:34:11 UTC, qznc wrote:
> On Monday, 7 October 2013 at 22:39:26 UTC, qznc wrote:
>> On Monday, 7 October 2013 at 20:36:46 UTC, Andrei Alexandrescu
>>> OP: any chance to adjust that page? Then we'll announce to reddit.
>>
>> Too early for more publicity, I think.
>
> Now every chapter has "some" text. Feel free to publicize it.

A small issue:
http://qznc.github.io/d-tut/meta.html

The width of the code in "String Mixins" overflows under the menu.

Also, I liked the previous design more, with some orange.

On Monday, 7 October 2013 at 19:18:40 UTC, qznc wrote:
> I believe one of the things D needs right now is more documentation. Therefore, I started writing a tutorial.
>
> It is aimed at people who can already program well in other languages. This means nothing about loops or structs, because I expect most people to know this stuff. I do not consider D to be a language for beginners anyways.
>
> It is aiming for pragmatic not comprehensive advice. For example, I mostly ignore LDC and GDC except for the optimization chapter.
>
> Since I am working on Linux exclusively and I like the command line, I cannot teach to Windows users. Sorry.
>
> This is still very incomplete and my our newborn family member requires quite some attention. So expect this to develop with glacial speed. ;)
>
> Nevertheless, I want to put this version 0.1 out to get some feedback. What do you think about the topic selection? What topics are missing? Serious errors so far?
>
> http://beza1e1.tuxen.de/d-tut-0.1/index.html
>
> Wreck it! :)

I like it! But I just think it lacks a bit more lengthy code examples, just to better assess the look-and-feel of D.

Nicolas

http://qznc.github.io/d-tut/basics.html
You make it sound like linking with C++ libraries is an easy task. I think, I know how to express difference between C++ and D: newer versions of C++ can compile legacy C++ code, while D drops C++ compatibility for language redesign, which leads to very limited compatibility with C++, but reasonably retains C ecosystem. C++ ecosystem is the feature of C++, similar to Java, this often outweighs purely linguistic features. This can be added to the "Criticism" section.

http://qznc.github.io/d-tut/debugging.html
The template syntax wasn't introduces at this point.

Unfortunately, there is no logging module in the standard library as of October 2013.
Such materials tend to bit rot, so it's better to mention the date.

-gc switch may be needed for the debugger to be able to demangle symbols, though I can't recall for which combination of OS, platform, compiler and debugger it's needed. I saw it in this forum, but can't find.

Code examples are without background, which is not as nice as in the previous version.

On Sunday, 13 October 2013 at 09:42:48 UTC, Kagamin wrote:
> http://qznc.github.io/d-tut/basics.html
> You make it sound like linking with C++ libraries is an easy task. I think, I know how to express difference between C++ and D: newer versions of C++ can compile legacy C++ code, while D drops C++ compatibility for language redesign, which leads to very limited compatibility with C++, but reasonably retains C ecosystem. C++ ecosystem is the feature of C++, similar to Java, this often outweighs purely linguistic features. This can be added to the "Criticism" section.

Yes, that part should be more detailed, but I have to learn that myself yet. Something like classes, overloading works, but templates (STL, Boost) does not.

I would not consider this "criticism", since most other languages (Python,Rust,Go) require C wrappers for C++ libraries.

> http://qznc.github.io/d-tut/debugging.html
> The template syntax wasn't introduces at this point.

Good point.

> Unfortunately, there is no logging module in the standard library as of October 2013.
> Such materials tend to bit rot, so it's better to mention the date.

Correct. That is not a problem specific to the logging statement, though. Every page contains the date in the footer.

> Code examples are without background, which is not as nice as in the previous version.

I am not sure about this. Personally, I see myself skipping either the text or the code blocks, when the have different backgroud colors. The same-background design tries to encourage reading text and code as one unit.

On Tuesday, 8 October 2013 at 00:29:34 UTC, Meta wrote:
>
> "Sometimes D is criticised, because it is not simple language, in contrast to Go, Rust, Lisp, or Scala. However, a D programmer sees no problem and actually likes his big toolbox."
>
> I wouldn't call any of those languages simple, except for Go. Maybe Go, C, Scheme, Python?

+1

On Sunday, 13 October 2013 at 13:09:45 UTC, qznc wrote:
> I would not consider this "criticism", since most other languages (Python,Rust,Go) require C wrappers for C++ libraries.

I meant a discussion on how to compare D to C++. Can't tell if it's criticism or philosophy. Well... this topic is probably too involved.

BTW an interesting discussion on the state of qtd:
http://forum.dlang.org/thread/kvgdxxkemzicumwfejad@forum.dlang.org