added more examples, began proposal doc