docs; fix default example
refactor populate
fixed; depopulation of mixed documents

closes #1471
docs;