• via Digitalmars-d-bugs (71/71) Aug 27 2017 https://issues.dlang.org/show_bug.cgi?id=17789

via Digitalmars-d-bugs <digitalmars-d-bugs puremagic.com> writes:

https://issues.dlang.org/show_bug.cgi?id=17789

          Issue ID: 17789
           Summary: Use a much more practical and beginner-friendly
                    landing page on Dlang.org, integrating Dlang-Tour
                    try-it-online examples
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody puremagic.com
          Reporter: ecstatic.coder gmail.com

My proposal is change the Dlang.org main page so that it just :

1. Say "Welcome to D"

2. Show how D is nice, ending with a link to the feature page

3. Show how simple D code looks like, using 4 well chosen examples, with the
first on the right of the main page.

4. Show how easy it is to learn D.

5. Show how easy it is to install DMD and a simple editor like CoEdit on any
win/mac/linux computer.

So in practice, I'd advice the landing page to become something like that :

"Welcome to D

What is D?

D is the culmination of decades of experience implementing compilers for many
diverse languages and has a unique set of features:

    high level constructs for great modeling power
    high performance, compiled language
    static typing
    direct interface to the operating system API's and hardware
    blazingly fast compile-times
    memory-safe subset (SafeD)
    maintainable, easy to understand code
    gradual learning curve (C-like syntax, similar to Java and others)
    compatible with C application binary interface
    limited compatibility with C++ application binary interface
    multi-paradigm (imperative, structured, object oriented, generic,
functional programming purity, and even assembly)
    built-in error detection (contracts, unittests)

... and many more {features}.

Take a tour

Want to try D online ? Simply click on the "run" button (or Ctrl-enter) below
the example on the right to compile and run it. And the example can be freely
edited if you want to experiment with D programming.

If you want to see other examples, click on the "next" button below to see the
next example of the dlang-tour.

Further readings

* New to programming? Learn programming quickly and easily with the D language,
using these freely downloadable books :

  * {http://ddili.org/ders/d.en/index.html}
  * {https://www.tutorialspoint.com/d_programming/}

* Already an experienced programmer? ...

  * etc etc ...

Installing D

...

* {https://dlang.org/download.html}

* {https://github.com/BBasile/Coedit}"

Moreover I advice there are at least the following code samples for the
Dlang-Tour :

  1. How to declare, initialise and print simple variables (bool, int, float,
string, int[], int[string]).
  2. How to declare simple imperative functions (something like
v=GetFibonacci(n) and GetFibonacci(v,n) with a ref argument)
  3. How to declare classes with attributes and methods
  4. How to declare and use a function like a class method
  5. How to declare and use structs and pointers
  6. How to declare and use a template function

This probably implies that Dlang.org and Dlang-Tour.org are to be merged.

--