update docs with suggestions
update docs with suggestions

briehl/narrative,kbase/narrative,kbase/narrative,kbase/narrative,kbase/narrative,kbase/narrative,kbase/narrative,briehl/narrative,briehl/narrative,briehl/narrative,briehl/narrative,briehl/narrative,briehl/narrative