mark required, optional and placeholder values as such
clean base structure, move compile and test scripts into scripts folder, use src instead of lib folder for spartan
optimise and document examples