Reorganize Learning Path for new learners #377
Description
In order to introduce new people to the language & hold their interest, I feel the page order of the language tour should be changed, quite a bit.
When comparing the order of pages, the tour tries to jump into more complex topics before describing the basics. Additionally, some sections seem misplaced (see bottom notes regarding "Ranges" and "Documentation")
This should make the tour more understandable to people less experienced in languages like C & provide a more organized approach.
Current "Basics" order:
- Imports/Modules
- Basic types
- Memory
- Mutability
- Control flow
- Functions
- Structs
- Arrays
- Slices
- Alias & Strings
- Loops
- Foreach
- Ranges
- Associative Arrays
- Classes
- Interfaces
- Templates
- Delegates
- Exceptions
- Further Reading
My Suggestion:
- Hello World (explicitly as one section, at the start, see note below)
- Basic types
- Functions
- Comments (/"Documentation", see note below)
- Control Flow (merge "Loops" into this Merge Loops into Control Flow #373 & Merges Loops & Control Flow #374 )
- Structs
- Enums (explicit addition)
- Arrays
- Foreach
- Memory
- Mutability
- Alias & Strings
- Associative Arrays
- Slices
- Classes
- Interfaces
- Templates
- Delegates
- Exceptions
- Imports and Modules
- Further Reading
Important notes about this change: (may need to be split into separate issues)
- Adds explicit "Hello World" section (Move out of Import example & move rest of this section to the end of the basics track. Can still refer to this section for the examples
import std.stdio: writeln;statement) - Adds explicit "Enums" section.
- Moves "Ranges" from "Basics" to "D's Gems" (immediately before "Range Algorithms")
- Moves "Documentation" from "D's Gems" to "Basics" and complete section with more on comments in general.