Document high-level onion service APIs

The OnionService type, and its methods, are really underdocumented. We should explain what they do and how to use them.