We need more thorough documentation explaining how things work & what the typical usage patterns should be