linux-credentials / linux-credentials/credentialsd

Find a better name for "devices" in GetAvailablePublicKeyDevices

Open
#80 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

architecture
Dominant language
Rust
Stars
259
Forks
19
Avg merge
1d 2h
Merged PRs (30d)
12

Description

From the documentation:
> The word "devices" is used broadly and can refer to individual authenticators (like a locked passkey provider or linked hybrid device), a group of authenticators on a transport (USB or hybrid QR code devices), or even an individual credential (in the case of credentials supplied by unlocked passkey providers).

We should choose a different word besides "devices" that isn't so confusing. "sources" probably works better. It was originally avoided because there is a term for _credential sources_ in the WebAuthn spec that means something else, but perhaps it wouldn't be confusing in this case.

I'm open to other alternatives too.

This would change the name of the `GetAvailablePublicKeyDevices()` method.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the GetAvailablePublicKeyDevices() method in the specification and all references to it. Review the surrounding WebAuthn terminology, then settle on an unambiguous replacement name and update the method consistently; done means the API no longer uses the confusing “devices” term.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux, rust
Domain
api
Issue type
Refactor
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.