improved Makefile
updated docs/specs, added stimulus