Skip to content

creating-an-issue doesn't talking about cross-referencing / explain how to cross-reference #42376

Closed

Description

@jsoref

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue

What part(s) of the article would you like to see updated?

Talk about cross-referencing

Additional information

https://docs.github.com/en/discussions/guides/best-practices-for-community-conversations-on-github#community-conversations-in-github-discussions

For more information about opening an issue and cross-referencing a discussion, see Creating an issue.

Activity

  1. added
    contentThis issue or pull request belongs to the Docs Content team
    on Jan 13, 2026
  2. added
    triageDo not begin working on this issue until triaged by the team
    on Jan 13, 2026
  3. faizanbsc0-stack commented on Jan 14, 2026

    @faizanbsc0-stack
  4. Sharra-writes commented on Jan 23, 2026

    @Sharra-writes
    Contributor

    @jsoref Yeah, I see your point. This is part of an old docs set, so no on will care too much what's done to it. I'm going to put a help wanted label on to see if someone wants to pick it up before I have time to get to it, since I'm going to have to find out more about cross-referencing, and someone else might already have that knowledge.

    To clarify for anyone who might want to pick it up: this Community conversations section links to Creating an issue as a source for more information about cross-referencing discussions in an issue, but there's no information on that in the article.

  5. added
    help wantedAnyone is welcome to open a pull request to fix this issue
    issuesContent related to issues
    and removed
    triageDo not begin working on this issue until triaged by the team
    on Jan 23, 2026
  6. Aimaghsoodi commented on Feb 26, 2026

    @Aimaghsoodi

    I opened a small docs-only draft PR to address this by explicitly noting that Create issue from discussion creates a cross-reference between the discussion and the issue: #43140. Happy to adjust or close if you want this phrased differently.

  7. jsoref commented on Feb 26, 2026

    @jsoref
    ContributorAuthor

    @Aimaghsoodi that doesn't look at all like what I'm expecting.

    The page that talks about converting is here:
    https://docs.github.com/en/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion

    Which isn't close to where you've changed things or added content.

    I'm actually looking for something that explains how to make links in conversations, not how to make links in a discussion by killing an issue -- which is what happens if you take the path you've documented.

    I'm actually looking for this:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamhelp wantedAnyone is welcome to open a pull request to fix this issueissuesContent related to issues

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions