joshfree
commented
3 years ago Thanks for reporting this issue @CaymanTurtleBeach. @rickle-msft from the storage team can follow up with you shortly on the broken links on https://github.com/Azure/azure-storage-java.
For the v12 Javadocs, you can find them either by going to https://docs.microsoft.com/en-us/azure/developer/java/ and clicking "See more..." link on the far right under Azure SDK for Java, OR you can follow this https://aka.ms/azsdk link, click Java, then click the docs link next to any package.
Here's the MSDocs and Javadocs, respectively for Blob Storage (from https://aka.ms/azsdk)
https://docs.microsoft.com/en-us/java/api/overview/azure/storage-blob-readme?view=azure-java-stable
https://azuresdkdocs.blob.core.windows.net/$web/java/azure-storage-blob/12.10.1/index.html
rickle-msft
CaymanTurtleBeach
gapra-msft
Describe the bug The links to 'Reference' in the table for Java storage libraries don't work (
https://github.com/Azure/azure-storage-java). The e-mail address carefully encoded in the document that explains the need for V12.x is wrong (the link from the above page does go to the document). The effort that went into creating the document, and the potential goodwill it might have engendered, is completely squandered when basic information links don't work. This is so emblematic of my experiences over 3+ years of attempting serious development on Azure (functions, VMs, Spring Boot servers). Does anyone, anywhere, within Microsoft check anything any time? It seems all that Microsoft does is throw words together and publish them; accuracy, utility, usability be damned.As an aside, which I have complained about in the past with respect to V8.x libraries, why does MS make Javadocs so hard to find (I have yet to find it for V12). Javadoc means something to Java programmers. Is it so hard to use that exact word to link to Javadoc documentation?? Every other phrase (link) with documentation in it points to MS pablum that may or may not be useful, but definitely is not Javadoc.
Exception or Stack Trace Add the exception log and stack trace if available
To Reproduce Go to
https://github.com/Azure/azure-storage-java(by address, a seemingly top-level location for information about Java libraries) Click the 'Reference' link in the table for V12 libraries - get 404 read the explanatory document. look at the link at the end of the document.Code Snippet Add the code snippet that causes the issue.
Expected behavior A clear and concise description of what you expected to happen.
Screenshots If applicable, add screenshots to help explain your problem.
Setup (please complete the following information):
Additional context Add any other context about the problem here.
Information Checklist Kindly make sure that you have added all the following information above and checkoff the required fields otherwise we will treat the issuer as an incomplete report