add changeset and improve docs #1593

Job	Run time
Install deps, build required package, typecheck, lint and test	4m 22s
	4m 22s

Provide feedback