[docs] Reorganize public Documentation

[jonpryor]

Context: https://learn.microsoft.com/dotnet/android
Context: https://github.com/dotnet/docs-mobile
Context: https://dotnet.microsoft.com/en-us/platform/support/policy/xamarin

Support for Xamarin.Android ends on 2024-May-1.

Along with end of support, documentation for Xamarin.Android will be de-listed: the content will still be there, but search will not return results within it, and search engines will not find it.

Meaning that after May-1 there will be no documentation for error and warning messages such as XA0000.

We now have a new documentation site for .NET for Android, https://learn.microsoft.com/dotnet/android!

This new site takes content from
https://github.com/dotnet/docs-mobile, which isn't currently public, but we are in the process of making it public.

Meanwhile, the Documentation directory was always intended to be a source of some documentation, so that documentation for new features could exist concurrent with the commit introducing the feature. This is not a workflow we wish to change.

To make synchronization easier, create a new
Documentation/docs-mobile directory which mirrors the contents of docs-mobile/docs/android, and migrate over our existing docs into the new directory structure.

[jonathanpeppers]

I don't know how the sync thing works, but this links to an old Xamarin doc?

So, we'd plan on moving this doc at some point?

[jonpryor]

I didn't want to take the time to migrate over every URL that mentioned /xamarin, and as the old /xamarin/android docs are only being delisted and not removed, I figured that this would be acceptable for now.

Mid-to-long term, yes, we should migrate over the referenced documentation so that everything lives within /dotnet/android.

[jonathanpeppers]

Is this supposed to be a markdown link? Or are we really wanting the text <https://github.com/xamarin/xamarin-android> to show?

[jonathanpeppers]

This is in here a couple other times.

[jonpryor]

Yes, that's supposed to be a Markdown link; see rendered: https://learn.microsoft.com/en-us/dotnet/android/messages/adb0010

Note that nothing in the open source https://github.com/xamarin/xamarin-android repository emits ADB0010, …

I think there are two implied questions here:

1. Should we be mentioning it here?
2. Should we even be mentioning xamarin/xamarin-android, anywhere?

Regarding (1), perhaps not: it's likely extraneous information that doesn't really help anybody, and thus we should consider removing the ## Implementation notes sections from all the adb* messages.

Regarding (2), it is the current repo location (though we want to do that around June…), and it does make sense to mention it when relevant, e.g. in xa0107.md:

Consider submitting a [bug](https://github.com/xamarin/xamarin-android/wiki/Submitting-Bugs,-Feature-Requests,-and-Pull-Requests)
if you are getting this warning under normal circumstances.                                                                  

We could consider creating an aka.ms shortlink instead of directly linking to the repo.

That, there are also the Release notes, which directly link to xamarin/xamarin-android and are directly mentioned in TOC.yml (if not yet rendered), and we likely don't want to create short links for each one of those…

[jonathanpeppers]

I think PoliCheck wants one phrase reworded:

Tool: PoliCheck: Rule: 185837 (Term: Oriya. TermClass: Geopolitical. Action: Action : Context = When used to refer to the language spoken in India and/or the script in which it is written in modern contexts.; ActionRecommendation = <b>REPLACE WITH</b> "Odia"; Context = When used to reference the Unicode block, code chart, or names of individual characters or code points.; ActionRecommendation = <b>Leave term unchanged</b>; ). 
Term: 'Oriya'. Term class: Geopolitical. Term table: en-9. Position: Line: 1643. Context(term at 34): '  \[x-iscii-as, CP57006\], *ISCII Oriya* \[x-iscii-or, CP57007\],'.

[jonpryor]

@jonathanpeppers wrote:

I think PoliCheck wants one phrase reworded:

Tool: PoliCheck: Rule: 185837 (Term: Oriya. TermClass: Geopolitical. Action: Action : Context = When used to refer to the language spoken in India and/or the script in which it is written in modern contexts.; ActionRecommendation = <b>REPLACE WITH</b> "Odia"; Context = When used to reference the Unicode block, code chart, or names of individual characters or code points.; ActionRecommendation = <b>Leave term unchanged</b>; ). 
Term: 'Oriya'. Term class: Geopolitical. Term table: en-9. Position: Line: 1643. Context(term at 34): '  \[x-iscii-as, CP57006\], *ISCII Oriya* \[x-iscii-or, CP57007\],'.

The warning itself states:

Context = When used to reference the Unicode block, code chart, or names of individual characters or code points.; ActionRecommendation = Leave term unchanged;

This usage is in reference to the Unicode block, and thus (in theory) should be left unchanged.

That said, is the $(MandroidI18n) property even supported? Does it do anything anymore?

[jonathanpeppers]

I don't think $(MandroidI18n) actually does anything, as that would be in implemented in dotnet/runtime now. (They would use a different property if anything like it exists)

[jonpryor]

Context: https://review.learn.microsoft.com/en-us/help/platform/navigation-toc-overview