[Storage] Updates to the Storage Overview page in reference docs

[HarshaNalluru]

Following docs refer to azure-storage package.
https://review.docs.microsoft.com/en-us/javascript/api/overview/azure/storage?view=azure-node-preview&branch=master

Should be updated to V10 storage packages (and V12) (Update https://github.com/MicrosoftDocs/azure-docs-sdk-node/blob/master/docs-ref-services/storage.md)

[ramya-rao-a]

@maggiepint, @kaerm Can either of you pick this up?

[ramya-rao-a]

Update:

• The link to the Storage Overview page: https://docs.microsoft.com/en-us/javascript/api/overview/azure/storage?view=azure-node-latest&branch=master
• Samples should be updated to refer to the v12 version of @azure/storage-blob library with pointers to corresponding queue and file-share packages

[ramya-rao-a]

Also, all the samples link in the overview page are broken leading to 404

[kaerm]

Thanks! The content team is aware of it and should be getting to it soon

[ramya-rao-a]

Any updates on this @kaerm?

[kaerm]

Content team is busy updating other documents but I believe @maggiepint volunteered for that one

[ramya-rao-a]

@kaerm, @maggiepint The above samples links continue to lead to 404

[ramya-rao-a]

@HarshaNalluru Let's fix this on our own :)
Below are some pointers:

• https://github.com/MicrosoftDocs/azure-docs-sdk-node/blob/master/docs-ref-services/storage.md is the markdown file to update and send PR
• Use the Java counterpart as a reference if needed: https://github.com/Azure/azure-docs-sdk-java/blob/master/docs-ref-services/storage.md

[ramya-rao-a]

On second thoughts, it seems redundant to have code snippets both here and maintain them on the package readmes.

How about having a 1 line description under the Client and the Management headers. Then add the list of packages available as links. The links should go to the npm package.

[kaerm]

shouldn't the links go to our README? Maybe the best way is to copy the table that Java has https://github.com/Azure/azure-docs-sdk-java/blob/master/docs-ref-services/storage.md

could be in a form of simple links or having individual storage libraries (queue, blob) listed for each row

[ramya-rao-a]

The npm package link is our readme.
For example: https://www.npmjs.com/package/@azure/storage-blob

I like the table of available libraries, but I would very much like to avoid having any code snippets at this leve

[kaerm]

Right, I know. I am definitely happy with not maintaining code but it would be good to have links to npm, samples, QS, source

[HarshaNalluru]

How does it look? Opened a draft PR here - MicrosoftDocs/azure-docs-sdk-node#672

Disclaimer: I don't have the links for the #ToBeAdded placeholders.

[ramya-rao-a]

I would skip the column for the source code.
Source code link is available from the npm landing page.

Is the getting started meant for links to Quick starts?

Change column header NPM link to Package or NPM package

[kaerm]

Added comments in the PR

[HarshaNalluru]

Is the getting started meant for links to Quick starts?

@ramya-rao-a, yes. You'd like a rename?
Moreover... Currently, it has been written only for the blob package.

Now..

Updated rest of the feedback in the PR, let's continue over there.
PR - MicrosoftDocs/azure-docs-sdk-node#672