Mod note: As of SDK 1.5.0 Scenarios have been superseded by the more powerful Daml Script. We now recommend using that for all purposes. For more information, and to learn how to use Script please check out @Andreas’ post on our blog.
Mainly for the attention of @Gary_Verhaegen
So first of all I’d like to point out the things that I have loved about DAML so far.
I love that it is intended as a low-coding environment and that a huge amount of the boilerplate has been abstracted away.
I appreciate that the tools are open-source and free for a large number of cases. I love the VSCode plugin, the DAML assistant, the scenario codelens. All of this has made my life much much easier.
In terms of issues I’ve had a long the way (and bear in mind I only started 10 days ago and since I’m a non-coder some of these things are probably specific to my introduction to programming and others to DAML itself)
The documentation assumes a fair amount of previous programming experience I feel and also doesn’t stress the importance of Smart Contracts in DAML being a new paradigm. I discovered this by accident on the DAML Medium blog several days later. Had I understand that context before starting out on the documentation, it would have a) boosted my confidence and b) got me upto speed much quicker.
As I said already I discovered the blog by accident and for some reason, some posts are on Medium while others are on the DAML site. It seems a little fragmented and that makes it harder to follow. That said the content is excellent and is confidence inspiring so no qualms with the content. While this isnt directly linked to documentation, the blog provides very important context which is useful in the documentation itself
Side point. Have you considered posting any of the content to places like HN? The one about smart contracts being different to traditional application patterns would probably do quite well on HN.
There’s a step right at the beginning about setting up the paths for Java and DAML. This step isn’t working for many especially on Mac and Linux because most people have to set this up via a config file explicitly. I had to go over to stackoverflow to find the solution to this, scattered amongst a few stackoverflow posts. That increases the amount of time someone gets up and running with the SDK if they’re just trying to have a dabble
While I like the fact that “create-daml-app” is an easy to understand concept, in the real world contracts are more likely to be used for the transfer of value as mentioned on your blog posts many times. Personally, I think it would have been much more helpful to have an equally simple app but that is related to the transfer of value in some way (some sort of super basic finance app for eg). With a simple social network, the idea of contracts gets confused a little and one starts to associated some of the concepts with traditional application patterns. At least that’s where much of my confusion initially stemmed from.
This one is a little nitpick. There are a fair few spelling and grammatical errors in the documentation, which makes it harder to trust what is written there.
That’s all I have for now. Hope that helps.