updated README with builder examples
added deprecations for unused matrix sources
working on #159