dao icon indicating copy to clipboard operation
dao copied to clipboard

Add Dao to "Learn X in Y minutes"

Open dumblob opened this issue 8 years ago • 3 comments

The repository https://github.com/daokoder/learnxinyminutes-docs needs some love.

  1. The repository does not currently contain Dao. The page https://learnxinyminutes.com/ already saved a lot of time to many people I know and now I need few good programmers to learn Dao, but they have to dig through the incomplete "long" documentation, which does not make them very happy.

  2. The Issues tab of the repository is off, making the repository hardly usable for cooperation.

@daokoder, do you have resources to address these?

dumblob avatar Feb 13 '17 12:02 dumblob

Adding Dao to "Learning X in Y minutes" would make it a nice starting place for learning Dao. I didn't prepare anything for this yet, as it seemed a bit premature at that time. Now you mentioned this, I think it is about to time to draft a Dao page.

We can include the followings in the page:

  • Commenting (single line, multiple lines);
  • Module loading (load math);
  • Declarations (const, var, invar, static and type);
  • Enum types (symbol, state and flag enums);
  • Core data types (bool, int, float, complex, string, array, list,map and tuple);
  • Conditional and looping controls;
  • Deferred block and error handling;
  • Routine and closure;
  • Code section method;
  • Class (inheritance and mixin);
  • Interface (abstract and concrete);
  • Asynchronous function call, asynchronous class and future value;
  • Channel and communication;
  • Parallelization methods;

We can add a such page to the standard help pages first, then to "Learning X in Y minutes" when it become ready.

daokoder avatar Feb 16 '17 08:02 daokoder

Sounds good. We shouldn't forgot to mention a general principle, that if something low-level is not explicitly defined, then it behaves exactly as in C99 or newer (e.g. rounding).

dumblob avatar Feb 17 '17 19:02 dumblob

Also we should mention conventions/rules. E.g. built-in types are small caps, other types UpperCamelCase.

dumblob avatar Feb 19 '17 13:02 dumblob