From my personal experience (note I am a first time Scala user and never have done anything with it before neither have I ever got in touch with sbt previously)
My biggest problem was how to get it running without falling back on the exercise files being given.
First I downloaded REscala from the Master branch. At first I did not know what to do what to begin with it. I quickly checked the exercise given to us and found this:
In comparison to the previous exercises it is necessary to first make
REScala locally available for sbt. This is done by checking out REScala from
https://github.com/guidosalva/rescala
and running sbt publishLocal
Following this I ran sbt publishLocal inside the root directory of REscala and thought I was all set and done.
I went on to create a new scala file.
For example:
I just wanted to make a quick scala application to test the Iterate function, as stated in the documentation I imported
Code: Alles auswählen
1 import rescala.
2 import rescala.events.
3 import makro.SignalMacro.{SignalM => Signal}
into the application.
Made an object with main and everything required and adapted the code shown on the slides. Trying to run it in sbt quickly resulted in compilation errors:
[error] ...: Not found object rescala
[error] import rescala._
[error] import rescala.events._
[error] ...: Not found: object makro
[error] import makro.SignalMacro ....
[error]not found: type ImperativeEvent
[error]val f = new ImperativeEvent[Int]();
^
! I remembered that there was this thing called build.scala where you had to "disclose" the dependencies. Googling how to find out the libraryDependency in order to put it into a build file did not lead to any helpful results, surely there must be some way to find out something like:
libraryDependencies += "de.tuda.stg" %% "rescala" % "0+"
especially this part
"de.tuda.stg" %% "rescala" % "0+"
.
I had to rely on the Build.scala provided by the exercise in order to get it working. This is where my problem comes in: without copy and pasting necessary files (in this case the Build.scala) I would still have no idea on how to make my own scala project with REscala. Should I ever have to use another external project I would probably have no idea how to properly use it.
Please don't get me wrong, this might not even be an issue with REScala's documentation. The "could really use some more documentation" was more based on the exercise / in general.
Maybe the problem even lies in my own misunderstanding in how to define build files for sbt or how to use sbt properly in general (except for the run and eclipse commands).