splits authentication and access token interfaces for go, java, dotnet and docs

[baywet]

completion of #1039

CC @Ndiritu @SilasKenneth when you move on to implementing azure authentication provider for PHP, and to update your abstractions as well.

[jobala]

I don't have historical context as to why we have AzureIdentity in struct and function names but we would be fine if we omit it because we only use azure identity so there's no need to differentiate structs and function names by an identity provider.

[baywet]

@jobala to answer your question it's just a branding/convenience naming.
On the technical aspect, TokenCredential, which is what our providers depend on at build time, is defined in azure-core. So the technical name of the structs should be TokenCredentialAuthenticationProvider.
However, with just TokenCredential, your app won't do much, you need one of its implementations which are all located in azure-identity, hence the name it to enable an easier mental association of the different components.
I hope this clarifies things.

[jobala]

it's just a branding/convenience naming.

In this case we should consider omitting AzureIdentity because it increases the length of names which takes a toll on readability. Long function/struct names are harder to read. But of course my suggestion trade offs mental association for shorter variable names and assumes doing so won't result in breaking changes.

[andrueastman]

I believe we still need to bump up the version numbers for the abstractions/authentication packages to avoid any issues during release

[baywet]

We do, I'm planning to do that in #1039 once all other PRs are merged into it

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
No Duplication information

[jobala]

Looks good, my only reservation is with having AzureIdentity in function, method and struct names in the Go components of this PR.

[baywet]

@jobala thanks for taking the time to review it. And that reservation is because the name is getting long?