Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

ASP.NET Core container quickstart: `docker-run: debug` task sample is missing its closing brace

Open Beginner friendly
  • Is something wrong?
#10,499 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@dannyward630 is already working on this.

Since Oct 17, 2026.

  • #10501 by @dannyward630 — open

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
csharp, docker, json, markdown
Domain
documentation

Research direction

The broken sample is the last JSON block in docs/containers/quickstart-aspnet-core.md, around lines 146-163, for the docker-run: debug task. Open that file, find the snippet that ends after the netCore block, and add the closing brace of the task object. Done when the snippet parses as a complete JSON object, for example with jsonc-parser, and the leading space before the first brace is removed.

Written by the indexing model from the issue text.

Description

Page: Tutorial: Create and containerize an ASP.NET Core app (docs/containers/quickstart-aspnet-core.md)

Problem

The last JSON sample on the page, which shows how to expose a fixed host port by changing the docker-run: debug task in .vscode/tasks.json, is missing its closing }. The object opened on the first line is never closed, so the snippet is not valid JSON and can't be pasted into tasks.json as shown:

 {
    "type": "docker-run",
    "label": "docker-run: debug",
    "dependsOn": [
        "docker-build: debug"
    ],
    "dockerRun": {
        "ports": [
            { "hostPort": 5000, "containerPort": 5000 }
        ]
    },
    "netCore": {
        "appProject": "${workspaceFolder}/netcorerest.csproj",
        "enableDebugging": true
    }

The braces open 3 times ({ task, dockerRun, netCore) but close only twice (dockerRun and netCore); the closing brace of the task object is missing. The same snippet is on the published page (checked today): it ends right after the netCore block.

I found this by parsing the fenced json blocks in docs/, api/, remote/ and learn/ with jsonc-parser; most reported blocks are intentional settings fragments, but this is the one complete task object that fails with CloseBraceExpected.

Expected

The sample is a complete, valid JSON object:

{
    "type": "docker-run",
    "label": "docker-run: debug",
    "dependsOn": [
        "docker-build: debug"
    ],
    "dockerRun": {
        "ports": [
            { "hostPort": 5000, "containerPort": 5000 }
        ]
    },
    "netCore": {
        "appProject": "${workspaceFolder}/netcorerest.csproj",
        "enableDebugging": true
    }
}

(The leading space before the first { can go as well.)

Fix

Add the missing } at the end of the snippet in docs/containers/quickstart-aspnet-core.md (around line 146-163).

Dominant language
Markdown
Stars
6.7k
Forks
5.8k
Avg merge
8h 41m
Merged PRs (30d)
123

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/vscode-docs

All issues in microsoft/vscode-docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.