Problem
In layouts/_shortcodes/community-lists.md, line 2 configures the fallback URL for contribution guidelines when .Page.Params.contributingUrl is omitted from page front-matter:
{{ $contribUrl := .Page.Params.contributingUrl | default "docs/contribution-guidelines" -}}
However, docs/contribution-guidelines does not exist in the site repository. The actual contribution documentation page is located at content/en/docs/contributing.md (which renders to /docs/contributing/).
Root Cause
- Line 2 of
layouts/_shortcodes/community-lists.md hardcodes "docs/contribution-guidelines" as the default fallback parameter.
- The site documentation structure uses
/docs/contributing/ for contribution guidelines.
- If the
contributingUrl front-matter parameter is omitted or removed from a page rendering the {{% community-lists %}} shortcode, the shortcode generates a link to /docs/contribution-guidelines/, which returns a 404 Not Found error.
Affected Components
layouts/_shortcodes/community-lists.md
Reproduction / Evidence
- Inspect
layouts/_shortcodes/community-lists.md line 2 and line 23:
{{ $contribUrl := .Page.Params.contributingUrl | default "docs/contribution-guidelines" -}}
...
[{{ T "community_guideline" }}]({{ $contribUrl | relURL }}).
- Note that
git ls-files content/en/docs/ contains content/en/docs/contributing.md (rendered at /docs/contributing/), while /docs/contribution-guidelines does not exist.
Acceptance Criteria
Proposed Solution Direction
Update line 2 of layouts/_shortcodes/community-lists.md to fallback to "/docs/contributing/":
{{ $contribUrl := .Page.Params.contributingUrl | default "/docs/contributing/" -}}
Problem
In
layouts/_shortcodes/community-lists.md, line 2 configures the fallback URL for contribution guidelines when.Page.Params.contributingUrlis omitted from page front-matter:However,
docs/contribution-guidelinesdoes not exist in the site repository. The actual contribution documentation page is located atcontent/en/docs/contributing.md(which renders to/docs/contributing/).Root Cause
layouts/_shortcodes/community-lists.mdhardcodes"docs/contribution-guidelines"as the default fallback parameter./docs/contributing/for contribution guidelines.contributingUrlfront-matter parameter is omitted or removed from a page rendering the{{% community-lists %}}shortcode, the shortcode generates a link to/docs/contribution-guidelines/, which returns a 404 Not Found error.Affected Components
layouts/_shortcodes/community-lists.mdReproduction / Evidence
layouts/_shortcodes/community-lists.mdline 2 and line 23:git ls-files content/en/docs/containscontent/en/docs/contributing.md(rendered at/docs/contributing/), while/docs/contribution-guidelinesdoes not exist.Acceptance Criteria
layouts/_shortcodes/community-lists.mdfrom"docs/contribution-guidelines"to"/docs/contributing/".community-listsrenders valid, resolving links to the Contributing page even whencontributingUrlis omitted from front matter.Proposed Solution Direction
Update line 2 of
layouts/_shortcodes/community-lists.mdto fallback to"/docs/contributing/":