Can you show me an example where a deep link to another guide paragraph is used? I cannot find a way to link directly to guide/directive#isolate_scope without adding the anchor above. Only IDs for API docs seem to be generated. Is there any guide on how to write or edit the docs?

I guess our suggestions aren't the best, but I would prefer to at least add some links in order to help people finding the right details. The documentation is sometimes spread across several sections and pages, which makes it hard for new Angular users to get the right idea on how to use the API. I only found out about isolateScope() after looking into the Angular code - probably due to my bad search terms, but helping users doesn't hurt I guess. :)