Bam: improve documentation