InnerSourceCommons / InnerSourceCommons/managing-innersource-projects

References: Display of overview, and integration in content pages

Open
#51 1 comment 0 reactions 1 assignee View on GitHub

@spier is already working on this.

Since May 14, 2025.

bug
Dominant language
Shell
Stars
15
Forks
18
PR merge metrics
No merged PRs in 30d

Description

It looks like when migrating from prior gitbook versions (years ago) to using the SaaS offering, the way that references to outside resources were handled changed significantly. Therefore those references are currently broken in multiple ways.

Reference overview does not show all references

When looking at the "What, When and How to Measure" / References page you only see 2 references displayed, while the actual markdown file contains 6 references

Pointing to the references from within the content pages

On the main "What, When and How to Measure" page you see a lot of pointers like [^1] that don't have any effect.
I suspect those were meant to generate links to the actual references.

The same issue exists on other pages as well.

Contributor guide

Open the contributing guide

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.