wrote another bit of documentation...