Anchors to specific module parameters in the docs?

5 views
Skip to first unread message

Dick Visser

unread,
Jan 29, 2020, 6:54:06 AM1/29/20
to ansible...@googlegroups.com
Hi

Not sure if this is the right place, but....
I used URLs to module documentation a lot, for instance:

https://docs.ansible.com/ansible/latest/modules/docker_container_module.html

But what I most of the time want, is to pinpoint to a specific
parameter of a module.
This isn't possible because the HTML doesn't contain any anchors.
Would this be a nice feature to add?
The list of parameters seems to be a table so it could be as simple as
adding an anchor to each row called "parameter_<parameter name>"?

thx


--
Dick Visser
Trust & Identity Service Operations Manager
GÉANT

Felix Fontein

unread,
Jan 29, 2020, 7:07:42 AM1/29/20
to ansible...@googlegroups.com
Hi Dick,

> Not sure if this is the right place, but....

it's probably better to create an GH issue for this.

> I used URLs to module documentation a lot, for instance:
>
> https://docs.ansible.com/ansible/latest/modules/docker_container_module.html
>
> But what I most of the time want, is to pinpoint to a specific
> parameter of a module.
> This isn't possible because the HTML doesn't contain any anchors.
> Would this be a nice feature to add?

Definitely! I've missed that myself several times already.

> The list of parameters seems to be a table so it could be as simple as
> adding an anchor to each row called "parameter_<parameter name>"?

Yes, it should be pretty easy to add. Can you create an issue and CC me
in there (@felixfontein on GitHub). I might create a PR for it this
weekend or so.

Cheers,
Felix



>
> thx
>
>

Reply all
Reply to author
Forward
0 new messages