graalvm / simplelanguage

A simple example language built using the Truffle API.

Home Page:http://openjdk.java.net/projects/graal/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Lack of usability

CyborTronik opened this issue · comments

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.