Azure-docs: 3.0 SDK Documentation and .Net Core

[stap123]

Are these docs going to be updated for the 3.0 version of the SDK sometime soon. I'd love to use this to create WebJobs on .Net Core but I can't find any official docs on the Microsoft site for creating a .Net Core WebJob.

The closest thing to seeing anything new I've found is this sample https://github.com/Azure/azure-webjobs-sdk/blob/00686a5ae3b31ca1c70b477c1ca828e4aa754340/sample/SampleHost/Program.cs from a comment on this issue https://github.com/Azure/azure-webjobs-sdk/issues/1870#issuecomment-417888043

---

Document Details

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

• ID: a4500b14-64b4-4d1b-aae3-f0fd4dde85f2
• Version Independent ID: 8fb75741-37b9-b45f-c0ca-9948ddaf1c06
• Content: How to use the WebJobs SDK - Azure
• Content Source: articles/app-service/webjobs-sdk-how-to.md
• Service: app-service-web
• GitHub Login: @ggailey777
• Microsoft Alias: glenga

[hillmarcus]

I'm working on building some WebJobs myself and am starting to doubt that I should use this library. I can't find a good source of documentation anywhere. MSDN says one things, github says another, the current version of the library doesn't really support either. The sample code @stap123 linked to doesn't compile on my system because half the methods being called can't be found.

The documentation needs to be updated _at the same time_ as the library, if not before.

[BryanTrach-MSFT]

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

[BryanTrach-MSFT]

@stap123 and @hillmarcus Upon further review we feel your feedback would be best received by the doc author to determine if an update to the current doc is necessary, or to create a new doc if they align with the feedback.

[jryousefi]

I found this https://docs.microsoft.com/en-us/azure/azure-functions/durable/durable-functions-webjobs-sdk#webjobs-sdk-3x.

[jryousefi]

also this: https://github.com/Azure/azure-webjobs-sdk/issues/1871

[ggailey777]

@hillmarcus sorry for the inconvenience, we are updating this article for v3.x of the WebJobs SDK this week.

[hillmarcus]

@ggailey777 Thanks for the update. I'll be eagerly awaiting the updated documentation. In the meantime I've just downgraded to version 2.X since I could find plenty of documentation on that.

I'm sorry if I came across a bit terse in my earlier comment.

[ggailey777]

@hillmarcis I agree that we have provided a very poor experience for SDK v3.x, which is very different thanks to .NET Core.

[eeropenttinen]

Stupid question: why don't you release the documentation and examples the same time with the SDK? Documentation and examples are essential components of an SDK.

[ggailey777]

@eeropenttinen you are totally correct. We dropped the ball on this one, and I apologize. We are trying to get this updated as fast as possible.

[adagarpallat]

When is the sdk, with documentation and examples expected?
Is there a timeline?

[ggailey777]

@adagarpallat I have it almost done, so hopefully by next week.
Is there an API you have a question about...I may be able to answer it here?

[ggailey777]

The updates are now live and we can #please-close this issue. Please reopen if we have not addressed your issue to your satisfaction.