rework documentation to address different scenarios and capture demo/template configs