search

Azure / azure-notificationhubs-dotnet

.NET SDK for Azure Notification Hubs
MIT License
70 stars 122 forks source link

Seems like this conversation is resolved. I'm going to close and lock this thread. #177

Open Tommigun1980 opened 3 years ago

Tommigun1980 commented 3 years ago

"Seems like this conversation is resolved. I'm going to close and lock this thread.

Originally posted by @marstr in https://github.com/Azure/azure-notificationhubs-dotnet/issues/10#issuecomment-520015851"

No! Don't close it -- update the documentation! The documentation is currently a permutation of all versions you have ever produced, with absolutely no guidance on how to select a template when sending a message. Half of the APIs are deprecated and it absolutely is not obvious how to do it - I like most others were looking for where to provide the template name in SendTemplateNotificationAsync - and the fact you can provide it as a tag is completely arbitrary and should definitely be documented. Even better, it should be an argument to the method, as the API is currently a frankenstein of all the different experiments you've done with the API.

It is unacceptable that the only documentation on how this works ins in a closed GitHub ticket. Shouldn't it be #1 priority for you guys to update the documentation, instead of closing a ticket, when people have no information on how to use an essential feature?

Thanks.

Tommigun1980 commented 3 years ago

Hello? Is this project maintained anymore or has it been killed off?

mpodwysocki commented 2 years ago

@Tommigun1980 This project is actively maintained and is a vital piece of our own infrastructure on Azure Notification Hubs. We are making it a priority to fix our documentation in the coming months.

Tommigun1980 commented 2 years ago

@Tommigun1980 This project is actively maintained and is a vital piece of our own infrastructure on Azure Notification Hubs. We are making it a priority to fix our documentation in the coming months.

I appreciate it, thank you. Up to date documentation is vital so if at all possible please focus on it in the future. It doesn't matter how good the underlying technology is if it's not well documented as the barrier of entry becomes high and the trust goes down.

I appreciate your hard work on this!