Skip to content
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

[Feature] Display module params in main hover tooltip, and add hovers for invoked params #89

Open
zswanson opened this issue Mar 2, 2018 · 3 comments

Comments

@zswanson
Copy link

zswanson commented Mar 2, 2018

While we can use the ansible module snippets to see the possible parameters of a module and their documentation, it is somewhat tedious to invoke the snippet and then have to delete all the comments and extra params that were not necessary. The existing hover tooltips just provide a link to the primary ansible online documentation; which while nice, leads to a lot of back & forth between the browser and VS Code when investigating a module for various options.

An improvement would be to add the list of possible parameters for a module (with some designation of mandatory/optional). Additionally being able to hover over a specific parameter and seeing the documentation for the specific allowable values or notes for that parameter would be great.

@yungez
Copy link
Collaborator

yungez commented Mar 5, 2018

@zswanson thanks for the feedback and suggestion. The feature sounds good to save user's effort to finish a snippet. While we need to figure out 2 things:

  • weather it's acceptable to majority users to remove optional parameters from code snippet.
  • what's different on parameters' description in code snippet and in document link.
    Will update here if any result.

@yungez
Copy link
Collaborator

yungez commented Mar 8, 2018

@zswanson here's investigation update:

  1. for add list of possible parameters for a module item. actually we're working on providing workable samples for modules so that user could direct run the samples. the feature will be coming soon maybe in next month.
  2. hover over on specific parameter to get allowed value, you could get the info in comments of current code snippets. and choice will be showed in comments also. like below code snippet for docker_login module:
reauthorize: yes # not required. choices: yes;no. Refresh exiting authentication found in the configuration file.

@zswanson
Copy link
Author

zswanson commented Mar 8, 2018

@yungez Sounds great!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants