Explain :user means username, not ID.

[cirosantilli]

It's the first question that comes to mind when you see :user, and that's the first place I searched for an answer.

[gjtorikian]

I only see two specific instances of :user on this page. It might be better to just substitute all :user strings with :username to avoid confusion, rather than the paragraph note.

[cirosantilli]

This would be a better solution, but it would still leave things unclear about the other parts of the documentation which still use :user: git grep :user shows up quite a few.

If they are all actually usernames, shall I perl -lapi it?

[gjtorikian]

This would be a better solution, but it would still leave things unclear about the other parts of the documentation which still use :user: git grep :user shows up quite a few.

Indeed.

Per 66406d9, I've gone through and changed the (correct) references of :user to :username to make this clearer to readers.

Thanks for bringing this up! 🤘