dotnet / dotnet/docs

Use console app template for dotnet publish container tutorial

Open
#45,858 2 comments 0 reactions 0 assignees View on GitHub
:pushpin: seQUESTered dotnet-fundamentals/svc
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
15h 21m
Merged PRs (30d)
370

Description

### Type of issue

Other (describe below)

### Description

I would like to suggest to use a console app instead of a service worker template as a sample project for the "[Containerize a .NET app with dotnet publish](https://learn.microsoft.com/en-us/dotnet/core/containers/sdk-publish)" tutorial.

**Why?**

When searching online, e.g. for "dotnet publish container", the tutorial is the first result. Also other articles, such as the "[Tutorial: Containerize a .NET app](https://learn.microsoft.com/en-us/dotnet/core/docker/build-container)", link *directly* to it.

Currently, the tutorial uses the worker template and SDK as the sample project. Therefore, it nowhere mentions the `` tag, because web and worker SDK projects implicitly reference it, while it's essential to add it to console application projects to make them publishable as containers.

IMHO: It would already be a huge improvement, if the tutorial article would mention the `` tag or link back to the relevant section of the "[Overview](https://learn.microsoft.com/en-us/dotnet/core/containers/overview)" page. But documentation that simply marks steps and information as optional, rather than inlining required ones as easily overlooked side notes, is even easier to follow and clearer to the reader. Also, console apps (and the used SDK), are the common base for both, woker and web projects, which would make the tutorial more universally applicable and less prone to leaving developers of simpler application types feeling lost due to implicit references and configurations present in more specialized templates. And therfore, `[goto: startOfIssueDescription]`

### Page URL

https://learn.microsoft.com/en-us/dotnet/core/containers/sdk-publish

### Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/containers/sdk-publish.md

### Document Version Independent Id

0e37627b-37c5-850b-08a2-41bd16630452

### Platform Id

158a640a-1b88-1e9c-5c97-de48cfa28d50

### Article author

@gewarren

### Metadata

* ID: b3889986-be82-b274-321c-d2fa84067c37
* PlatformId: 158a640a-1b88-1e9c-5c97-de48cfa28d50
* Service: **dotnet-fundamentals**

[Related Issues](https://github.com/dotnet/docs/issues?q=is%3Aissue+is%3Aopen+0e37627b-37c5-850b-08a2-41bd16630452)

---
[Associated WorkItem - 429413](https://dev.azure.com/msft-skilling/Content/_workitems/edit/429413)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.