minor clarifications to file system behaviour
minor editorial updates. Add TODO note to debugging topic
Merge pull request #2724 from hamishwillee/incoming

Minor clarifications to a few documents