twpayne / chezmoi

Manage your dotfiles across multiple diverse machines, securely.
https://www.chezmoi.io/
MIT License
12.9k stars 478 forks source link

More information on dashlanePasword #3218

Closed hulk510 closed 11 months ago

hulk510 commented 1 year ago

Is your feature request related to a problem? Please describe.

I successfully implemented to apply dashlane passwords using chezmoi, but it took a time to understand. Having more information in the dashlanePassword documentation would have been helpful in saving time.

Describe the solution you'd like

  1. It would be beneficial to include specific details about what the "filter" refers to. I read onepassword’s document first, so I thought "id" is filter parameter, however dashlanePassword filter "title" in the json.

output dashlanePassword json

  1. it would be helpful to provide guidance in the documentation regarding the usage of {{ (index (dashlanePassword "filter") 0).password }}. Firstly I write {{ (index (dashlanePassword "filter") 0).password }}, and it isn't changed to dashlane password value, I spent a significant amount of time attempting to troubleshoot, and I later realized that the file extension required set to template file. I believe that including some form of guidance or reference to the template page would be beneficial.

Describe alternatives you've considered

Additional context

halostatue commented 1 year ago

I agree with #1, and we would happily take a PR for that.

I’m less certain about #2, as the dashlanePassword template function is in the section on template functions. I think that there should be more cross-documentation linkage overall (and I have started doing so when it seems appropriate), but I’m not sure that this particular piece would be useful.

hulk510 commented 1 year ago

thanks for the reply.

oh, sorry I didn't realize there is in template section, and I confirm to exist in the section! スクリーンショット 2023-09-05 8 47 38

The section had a large amount of accordions open and seemed a bit difficult to notice right away. I thought it would be nice to have this sticky scroll, like the "reference" in the image, with the text changing from section to section.

halostatue commented 1 year ago

That would improve things, but it is a part of the documentation template I don’t know anything about (it’s all in mkdocs).

hulk510 commented 1 year ago

I see, thank you for sharing. I would like to create an issue if I find a good way to do this in mkdocs again.

Thank you very much.

twpayne commented 1 year ago

Thanks for offering to help @hulk510. I've assigned this issue to you.

twpayne commented 11 months ago

Please create a PR when you have one. In the meantime, I'll close this issue.