October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk3 min

How to Add a Comment Section to Your GitHub Profile With Discussions

A GitHub profile README can welcome visitors and link to a Discussion where they can join the conversation. Here’s how to set up both pieces.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You can invite comments from your GitHub profile by creating a profile README and linking it to a GitHub Discussion. The README appears on your profile; the discussion is where visitors can participate. GitHub’s documentation describes Discussions as a repository or organization forum, not as a comment thread embedded directly in an individual profile.

How the profile comment setup works

Think of this as two connected pieces: your profile README introduces the conversation and points visitors to it, while a Discussion hosts the conversation. GitHub describes Discussions as a place for transparent, accessible conversations that do not need to be tracked like issues and are not related to code. GitHub’s Discussions quickstart explains the feature.

As an Amazon Associate I earn from qualifying purchases.

Choose a repository Discussion for a project community, or an organization Discussion for a broader community. In either case, the Discussion’s visibility follows the repository that hosts it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Create the profile README

  1. Create a public repository named exactly after your GitHub username.

  2. Add a nonempty file named README.md at the repository root. Edit it to introduce yourself and tell visitors what you welcome them to discuss.

  3. Preview the rendered README before committing. GitHub’s writing guide explains that HTML comments such as <!-- COMMENT --> are hidden from rendered output, and recommends checking the Preview tab to confirm. Read the writing guide.

  4. Commit the README. If you commit directly to main, the change is visible to profile visitors.

    What’s actually slowing this PC down?

    Pick the symptom - the matching free tool is one click away.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

GitHub’s profile README instructions require the public, same-name repository and a nonempty root README. Managed user accounts cannot use profile READMEs. If an older same-name public repository created before July 2020 does not appear automatically, GitHub says to use Share to profile. The README stops appearing if it becomes empty, the repository becomes private, or its name no longer matches your username. See GitHub’s profile README instructions.

Choose where visitors will discuss

Use a repository Discussion for a project community

In the repository, open Settings, find Features, and choose Set up discussions. Repository owners and people with write access can enable Discussions; owners can edit the welcome post during initial setup. A repository’s visibility determines who can see its Discussions.

Use an organization Discussion for a wider community

An organization owner enables Discussions in the organization settings and selects a source repository. The organization’s Discussions appear on both the organization and source-repository discussion pages. Changing the source repository does not transfer existing discussions.

For either destination, open the Discussions tab, select a category, enter a title and body, then submit the discussion. Repository owners and people with write access can create categories. GitHub’s Discussions quickstart covers repository and organization setup.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Link the Discussion from your README

After creating the discussion, copy its URL and add a clear Markdown link in the README. For example:

Have a question or idea? [Join the discussion](PASTE-YOUR-DISCUSSION-URL-HERE) and share it in the appropriate category.

Replace the example text in the link with the actual Discussion URL. Add a brief prompt that tells visitors what belongs there—such as questions, suggestions, or introductions—so they know how to start. The link makes the README an invitation; it does not turn the profile itself into a native comment area.

Make the conversation useful and manageable

If you run the discussion space, use its welcome post to set expectations and direct new participants to the right categories. GitHub supports pinning and moderation tools, with permissions determined by the repository or organization setup. Review the available controls in GitHub’s guide to managing Discussions.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.