Update documentation with current thinking and BTRFS support