Skip to content

docs: add standalone Contributor License Agreement page (refs #12863)#13225

Open
AshrafHosam wants to merge 3 commits intoEbookFoundation:mainfrom
AshrafHosam:fix/standalone-cla-page
Open

docs: add standalone Contributor License Agreement page (refs #12863)#13225
AshrafHosam wants to merge 3 commits intoEbookFoundation:mainfrom
AshrafHosam:fix/standalone-cla-page

Conversation

@AshrafHosam
Copy link
Copy Markdown

What does this PR do?

Improve repo / Add standalone documentation page

Description

Refs #12863.

The reporter of #12863 expected a Contributor License Agreement page that displays only its own content. In the current repo, the CLA is a short section inside docs/CONTRIBUTING.md, so users who follow a CLA link land on the larger Contributing page and see unrelated content above it — which is what prompted the confusion in #12863.

This PR adds a dedicated CLA page so anyone can read the agreement in isolation:

  • New file: docs/CONTRIBUTOR_LICENSE_AGREEMENT.md — Jekyll frontmatter + only CLA text (rights, representations, license grant).
  • docs/CONTRIBUTING.md — the existing CLA section now links to the new page for the full text.
  • _config.yml — add CONTRIBUTOR_LICENSE_AGREEMENT.md to the included files list so Jekyll builds it.

No existing content is removed; the change is purely additive.

Why is this valuable?

Gives the CLA a clean, focused URL (docs/CONTRIBUTOR_LICENSE_AGREEMENT) without surrounding contributor-workflow material, addressing the core concern in #12863 ("The Contributor License Agreement page should display only its own content").

Checklist:

  • Search for duplicates.
  • Used an informative name for this pull request.
  • Additive documentation only; no existing content removed.

…undation#12863)

Issue EbookFoundation#12863 reports that the Contributor License Agreement is rendered
within docs/CONTRIBUTING along with unrelated content, making it hard to
read in isolation. The repository did not previously expose a dedicated
CLA page.

Add docs/CONTRIBUTOR_LICENSE_AGREEMENT.md containing only the CLA text
(rights, representations, license grant), include it in _config.yml, and
link to it from the CLA section of CONTRIBUTING. Users who want to read
only the CLA now have a clean, focused page.
Jekyll processes docs/ by default; the include list only matters for root-level files that would otherwise be excluded. Drops the extra artifact that was flaking the check-urls workflow.
@eshellman
Copy link
Copy Markdown
Collaborator

We'll need more info on the observed issue - I cant reproduce it

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants