While I’m not a fan of too many links in API doc comments (hard to update when things change), I do think that it’s best to keep the API docs terse and reference oriented. This is not the place for tutorials or guides.