Acknowledged
4 months ago

SDK: provide source files with "skeleton" code / documentation for all API symbols to support features such as: CTRL/CMD-click on symbol to go method signature/docs, and viewing docs in VS Code (instead of browser)

Currently:

- if you CTRL/CMD-click on an API symbol (e.g. AppBase.getApp()) in an attempt to go to the definition, nothing happens. This is expected, since there is no definition to go to.

- if you hover over an API symbol and click on an API symbol in the resulting hover info, the local SDK documentation opens in a web browser. This is ok, but it's also bit heavyweight. It would be great if the dev could see the documentation / method signature in VS Code

Both of these use cases could be fulfilled if the Connect IQ SDK provided a set of "skeleton" source files for all API symbols containing method signatures, member variable definitions, and documentation. This source could also include links to the local SDK documentation, if the dev really wants to see it in a browser.

I *think* this is how it works for languages like Java, TypeScript and python.

FlowState
Parents
  • 4 months ago

    I realize documentation can already be viewed in VS Code to a certain extent, as it's displayed on hover. But it would be nice if CTRL/CMD-click also opened the API "skeleton" source / documentation in VS Code, especially since I may want to click on links in the hover info and have them open in VS Code, as opposed to in a browser.

    It's a little inconsistent that I can get documentation within VS Code for anything that supports hover info, but if it's something I have to click on - such as a symbol mentioned in the hover info itself - the documentation will open in a browser.

Comment
  • 4 months ago

    I realize documentation can already be viewed in VS Code to a certain extent, as it's displayed on hover. But it would be nice if CTRL/CMD-click also opened the API "skeleton" source / documentation in VS Code, especially since I may want to click on links in the hover info and have them open in VS Code, as opposed to in a browser.

    It's a little inconsistent that I can get documentation within VS Code for anything that supports hover info, but if it's something I have to click on - such as a symbol mentioned in the hover info itself - the documentation will open in a browser.

Children
No Data