a more verbose readme (first draft)