-
Notifications
You must be signed in to change notification settings - Fork 696
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update docs to show examples of cross-linking #79
Comments
You can reference symbols (classes, functions, modules, etc.) using double brackets. Internally we use Did you encounter any problems linking to other symbols? |
Not yet, we haven't tried--we just weren't sure how it worked and I looked at the docs but didn't see an explanation. We just moved from YUIDoc to TypeDoc so we haven't yet changed all the old tags. |
Ah I just tried and the docs said "double angle brackets" so I thought it was |
I'm new to this, but I expected JSDodc {@link ...} to work for cross-linking to types and properties. Am I wrong? http://usejsdoc.org/tags-inline-link.html Update: Ah, I see - it's markdown. That said, principle of least surprise says JSDoc should work (in addition?) |
Hi oising, next version will support {@link ...} tags. |
@sebastian-lenz Sorry to chime in with a slightly off-topic note, but can the docs for typedoc be updated to say square brackets instead of angle brackets? Maybe write how it's resolved in the docs too. Just has a couple of surprises with that. |
Hi Blake, the docs are really outdated, sorry. They are on my list for a very long time. Maybe it would be better to remove them temporary and put them back online once they are up to date. |
has this link support stuff been added? as I have just picked this lib up to use and its great but the lack of up to date docs or even a quick link saying "go to http://usejsdoc.org/ for info" would have been great. |
I understand the logic behind going from children to parent symbols but, that implies that is not possible to reference a global symbol if there is a child with the same name. It would be great if I can reference the global namespace somehow so I can define absolute links to global symbols. Example:
In case I'm not missing something, would this change be acceptable for a PR? Should I create a separate issue for this ? Otherwise, change the logic and search from parents to child, that way I can always reference global stuff and for local stuff I must use absolute paths in case of collision. Thanks, keep it up |
@cancerberoSgx Thanks for the suggestion. Microsoft is working on defining an unambiguous way to reference other symbols (microsoft/tsdoc#9) that I think TypeDoc should eventually implement. I'd be hesitant to implement any changes to reference lookups before that is finalized. It would probably be good to open an issue to discuss this further. |
My related question to this on SO: https://stackoverflow.com/q/58429798/1076463 . The scenario described there does not work. A bit of debugging shows that:
What does work is:
Edit: just submitted PR #1117 for this. |
Currently docs don't show how to cross-link, it's only mentioned. Main question: does it need to be fully qualified?
The text was updated successfully, but these errors were encountered: