documented usage with blueprints