search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.3k stars 21.47k forks source link

Should have examples in Azure SDK for Node.js #63369

Closed josealvarez97 closed 8 months ago

josealvarez97 commented 4 years ago

It has been really hard for me to implement a basic template registration for apns. The code snippets are great, but I wish this same article had examples in other languages/frameworks such as Node.js. I went over the GitHub page (i.e., Azure SDK for Node.js) and the experience was poor too.

I accomplished implementing a template registration in the Node.js SDK only after I found an old article in the web that dates back to 2015.

The Azure SDK for Node.js seems to be as powerful as the one for C#, but it feels like a mystery to decipher because there is practically no single and comprehensive source of documentation.

Just something to consider. Cheers! 💯

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

josealvarez97 commented 4 years ago

I am generally a Google Cloud Platform customer. I decided to try Azure because I needed Push Notifications, and Azure Notification Hubs seemed to be a very good product for this need. So far I'm really, really happy with Azure Notification Hubs!

Still, I'd recommend not assuming that users of Azure Notification Hubs will necessarily prefer to implement a backend in C#. Not that I don't like C# -- in fact I really like it for other things (I'm developing a Unity app) --, just that I also really like Node for backends (less opinionated and simple to write, maybe?). It's more popular for back-ends for a reason!

Another consideration -- perhaps more important -- is that as a user of Google Cloud Platform, I would still like to use GCP products for my backend (e.g., App Engine, Cloud Functions) which usually do not support C# (but always Node).

Hence, documentation in Node is a must if you want to attract more people from other tech stacks into Azure. This time, I would say that the experience with the documentation hasn't been more pleasurable with Azure than other providers. It took me a day to wrap my head around a few concepts before I got it working, and that in addition of these little details do have an impact in my future decision making about new cloud products to try, and trust.

SnehaAgrawal-MSFT commented 4 years ago

@josealvarez97 Thanks for the feedback! We are currently investigating and will update you shortly.

SnehaAgrawal-MSFT commented 4 years ago

@josealvarez97 Thanks for the valuable feedback on this! I have assigned the issue to the content author for further review on this matter.

josealvarez97 commented 3 years ago

@SnehaAgrawal-MSFT @sethmanheim does the node.js API, when imported from azure-sb, has support for FCM template registrations? It seems it only has for GCM, which is deprecated.

josealvarez97 commented 3 years ago

I realized no one has worked on this issue since last year @SnehaAgrawal-MSFT . I would be happy to give it a shot at improving the documentation. In the end, I had to download the source code of the NodeJS API and take a look at the unit tests to get a better sense of how to use it. If I still remember correctly, there were two JavaScript APIs: one developed in NodeJS (old one) and one that works on any JavaScript runtime (newest one). I used the old one because it seemed (I remember) more robust. If it still makes sense to write documentation for that one, I can help.

sethmanheim commented 8 months ago

As we are moving to a new feedback system, please reopen this issue or contact Microsoft Support if you still want to provide feedback on the documentation. Thank you! #please-close