more examples + experimenting with docs.json