Make docs.ms link relative link

[sima-zhu]

https://raw.githubusercontent.com/Azure/azure-docs-sdk-java/main/docs-ref-services/preview/sdk-template-readme.md

Metadata definition: https://review.docs.microsoft.com/en-us/help/contribute/metadata-attributes?branch=main

[azure-sdk]

The following pipelines have been queued for testing:
java - template
java - template - tests
js - template
net - template
net - template - tests
python - template
python - template - tests
You can sign off on the approval gate to test the release stage of each pipeline.
See eng/common workflow

[danieljurek]

Can we get an example of this running and updating links? I think this can be accomplished by setting SetDevVersion to true and queuing a build for a service pipeline.

[sima-zhu]

Can we get an example of this running and updating links? I think this can be accomplished by setting SetDevVersion to true and queuing a build for a service pipeline.

The test is in description.

[azure-sdk]

The following pipelines have been queued for testing:
java - template
java - template - tests
js - template
net - template
net - template - tests
python - template
python - template - tests
You can sign off on the approval gate to test the release stage of each pipeline.
See eng/common workflow

[danieljurek]

LGTM!

I think one small corner case still exists here: someone uses a language region-language code is used here that isn't en-us ... We could try to match against a list of possible codes but I don't think the effort needed to generate and maintain such a list would be worth it in the scope of this effort.

Searching through the Java codebase reveals that other language codes are not in use in our README.md files.

Furthermore those errors would be flagged as warnings in OPS and could be addressed on a case by case basis if we start seeing more pop up.

[weshaggard]

I thought about the other languages as well but based on our link guidance folks shouldn't even have the /en-us in the link either so I think we are probably ok here and we probably can even remove that from the regex if we wanted but I'm fine keeping as well.

[weshaggard]

Why were these removed?

[sima-zhu]

This is according the their metadata guidance. If we use the ms.service, then the set of ms.prod and ms.technology are not necessary.
https://review.docs.microsoft.com/en-us/help/contribute/metadata-attributes?branch=main

[sima-zhu]

There are many OPS warning regarding we are using wrong ms.prod value

[sima-zhu]

I think we should leave the other locale as it is, so people can redirect to the right language as they defined.

[ghost]

Hello @azure-sdk!

Because this pull request has the auto-merge label, I will be glad to assist with helping to merge this pull request once all check-in policies pass.

p.s. you can customize the way I help with merging this pull request, such as holding this pull request until a specific person approves. Simply @mention me (@msftbot) and give me an instruction to get started! Learn more here.