Skip to content

Add an AI use page under a new Policies menu - #63

Open
maraattia wants to merge 1 commit into
mainfrom
ma/ai-use-page
Open

maraattia wants to merge 1 commit into
mainfrom
ma/ai-use-page

Conversation

@maraattia

@maraattia maraattia commented Nov 6, 2026 •

Copy link
Copy Markdown

Summary

Adds a public page on how AI tools are used in PROTEUS development, at /ai, and groups it with the License page under a new Policies menu. The page follows the structure of the License page: core values in brief, then one section per point (how the tools are used, responsibility, verification, disclosure, and AI tools and open source). Draft for discussion among the leads before merge.

Changes

  • src/pages/ai.astro: new page "AI use and responsibility".
  • src/data/settings.js: License moves into a Policies dropdown together with the new page.
  • src/components/Footer.astro: the Navigate column also lists the entries of dropdowns marked inFooter, so License stays in the footer and AI use joins it.
  • src/layouts/Base.astro: /AI and other casings redirect to /ai, as for the other pages.

Validation

  • astro build with Node 22.23.4: 9 pages built, including /ai/index.html.
  • npx playwright test against the local preview: 7 passed.
  • In the browser: the Policies dropdown opens on hover and sets aria-expanded, the footer lists License and AI use, and /ai has no horizontal scroll at 390 px width.

Open points

  • The disclosure section argues for project-level disclosure with no tool name in commits, and names the SFC and ASF recommendations for per-commit disclosure. Please check the argument.
  • The copyright paragraph ends with our own reading that users lose nothing if some code is not protected by copyright. Keep or cut.

Relevant people

@timlichtenberg @nichollsh @egpbos

The new page at /ai states how AI tools are used in PROTEUS development, who is responsible for the result, how results are verified, how AI use is disclosed, and how AI-assisted code fits the open source licensing. License and AI use now share a Policies dropdown, and the footer keeps listing both.
@maraattia
maraattia marked this pull request as ready for review November 6, 2026 16:07
@maraattia
maraattia requested a review from a team as a code owner November 6, 2026 16:07

@egpbos egpbos left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Some minor phrasing suggestions.

Comment thread src/pages/ai.astro

<p>AI tools are not authors of our code, papers, or reviews.
Publishing ethics bodies take the same view: the Committee on Publication Ethics <a href="https://publicationethics.org/guidance/cope-position/authorship-and-ai-tools" target="_blank" rel="noopener noreferrer">states</a> that AI tools cannot be listed as authors, because they cannot take responsibility for the work.
The <a href="https://joss.readthedocs.io/en/latest/policies.html" target="_blank" rel="noopener noreferrer">Journal of Open Source Software</a>, where the PROTEUS software paper is under review, asks authors to affirm that human team members reviewed, modified, and validated all AI-generated content.</p>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The <a href="https://joss.readthedocs.io/en/latest/policies.html" target="_blank" rel="noopener noreferrer">Journal of Open Source Software</a>, where the PROTEUS software paper is under review, asks authors to affirm that human team members reviewed, modified, and validated all AI-generated content.</p>
This is also in accordance with <a href="https://joss.readthedocs.io/en/latest/policies.html" target="_blank" rel="noopener noreferrer">Journal of Open Source Software</a> standards, which asks authors to affirm that human team members reviewed, modified, and validated all AI-generated content.</p>

Just to future proof this sentence past the review stage.

Comment thread src/pages/ai.astro
<h2 class="section-label" id="open-source">AI tools and open source</h2>

<p>Our <a href="/license#open-development">license page</a> commits PROTEUS to building only on fully open source code.
The AI tools we use are proprietary services, and they are development tools in the same category as an editor or a code-hosting platform.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The AI tools we use are proprietary services, and they are development tools in the same category as an editor or a code-hosting platform.
The AI tools we use may be proprietary services, but they are development tools in the same category as an editor or a code-hosting platform.

This branch has not been deployed

No deployments
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