Learn ATS in Y minutes -- request for documentation review

[mark.l....@gmail.com]

Hi all,

Learn X in Y Minutes has community-made documentation for programming languages and tools, as example-driven "whirlwind tours" of each languages' features.  I made one for ATS, since none existed and I think it's a great documentation format to have.  Here's the rendered markdown, and the associated PR.  It's about 500 lines of well-commented ATS, and introduces language features as you read it.

I'm still relatively inexperienced in ATS, so I'd appreciate reviews to make sure all the explanations are sound and to make the code more idiomatic.  Reviews from less experienced ATS users would also be particularly welcome, to make sure it addresses the confusions you had when first using ATS.

Learn X in Y Minutes has been really helpful to me in the past learning other languages, since reading good code can be a great way to learn.  I hope we can make this equally helpful to new ATS programmers.

Thanks,

-Mark Barbone

[artyom.s...@gmail.com]

Hi Mark,

This is great. Thanks! I’ll take a closer look.

Надіслано з iPhone

17 січ. 2021 р. о 08:30 mark.l....@gmail.com <mark.l....@gmail.com> пише:



--
You received this message because you are subscribed to the Google Groups "ats-lang-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ats-lang-user...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/ats-lang-users/2f2cad00-f229-491a-bf7d-a064d5ec452en%40googlegroups.com.

[Hongwei Xi]

Thanks, Mark!

I took a quick read.

Your description of various ATS2 features is accurate.

To be honest, I myself often forget how certain things are done in ATS2 and

have to use 'grep' to find code examples helping me figure out. For example,

I find the information in Part 5 particularly helpful!

Given the scarcity of ATS2 documentation, I am also quite amazed by your being

able to figure out some very intricate features of ATS2 on your own.

Cheers!

--Hongwei

--

[Peter Damoc]

This is a wonderful resource! 

Another thing that I think would be useful for beginners is a short but complete example of the entire ATS syntax.
In other words, a minimal file that would require the entire parser to be implemented in order to pass compilation. 

Thanks,
Peter

[Timmy Jose]

Hello Mark,

The resource looks quite useful , especially to a beginner like myself. I'm a bit miffed that the PR has been open for a very long time. Hopefully it will get merged in soon. As an aside, if you could post an expanded version of the materials, it would be very useful as well. Just a suggestion!

Best Regards,

Timmy