graalvm / simplelanguage

A simple example language built using the Truffle API.
http://openjdk.java.net/projects/graal/
Universal Permissive License v1.0
608 stars 198 forks source link

Lack of usability #94

Closed CyborTronik closed 4 years ago

CyborTronik commented 4 years ago

After opening this about 3d time, I feel sad about such wonderful work and effort put on GraalVM.

If it is about making GraalVM or Truffle popular then good documentation is essential for a growing community. Specially a quick start like doc.

This repo is like learning Hibernate from example (it's possible by digging in source code, just wonder if it makes it rational).

I believe there could be little more attraction for this example as well if there would be a review of the code style for S.O.L.I.D. like principles and/or things described in Clean Code: A Handbook of Agile Software Craftsmanship by Robert C. Martin.