Title: Record the AI usage disclosure in the contributions sheet · Issue #108 · learningequality/.github · GitHub
Open Graph Title: Record the AI usage disclosure in the contributions sheet · Issue #108 · learningequality/.github
X Title: Record the AI usage disclosure in the contributions sheet · Issue #108 · learningequality/.github
Description: Overview The contributions sheet records every community pull request, but not what the contributor said about their use of AI. Reviewers are reading that out of each pull request by hand. Add a column that records the disclosure, and a ...
Open Graph Description: Overview The contributions sheet records every community pull request, but not what the contributor said about their use of AI. Reviewers are reading that out of each pull request by hand. Add a co...
X Description: Overview The contributions sheet records every community pull request, but not what the contributor said about their use of AI. Reviewers are reading that out of each pull request by hand. Add a co...
Opengraph URL: https://github.com/learningequality/.github/issues/108
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Record the AI usage disclosure in the contributions sheet","articleBody":"## Overview\n\nThe contributions sheet records every community pull request, but not what the contributor said\nabout their use of AI. Reviewers are reading that out of each pull request by hand.\n\nAdd a column that records the disclosure, and a second one a maintainer can use to mark a\ndisclosure they do not believe.\n\n**Complexity:** Low\n**Target branch:** main\n\n### Context\n\n`scripts/update-pr-spreadsheet.js` runs daily in this repo since #101, and upserts every public\ncontributor pull request in the org updated in the last two days.\n\n`COLUMNS` covers A to H, and `toRow` produces those eight values: state or merge date, url, author,\ntitle, repo, created date, requested reviewers, assignees.\n\nTwo details decide how much work this is:\n\n- updates are written cell by cell, and the loop only covers the eight values from `toRow`\n- appends use the range `A:H`\n\nSo the automation never writes past column H, and it matches existing rows by the pull request url\nin column B. A column to the right of H survives every run untouched.\n\nThe pull request template already requires an `## AI usage` section, and #102 fails a run when that\nsection is absent, empty, or still the `…` placeholder. So the disclosure is enforced at the source,\nand this sheet only has to record it.\n\n### The Change\n\n**Column I, written by the automation.** Read the `## AI usage` section from the pull request body\nand record whether it holds a real disclosure. #102 parses the same section, so the two must share\none implementation rather than each growing their own.\n\nExtend `COLUMNS` to `I`, add the value to `toRow`, and change the append range to `A:I`.\n\n**Column J, written by hand.** A maintainer marks a disclosure they do not believe, for example\nwork that reads as generated under a statement that no AI was used. The automation leaves this\ncolumn alone, because it writes nothing past the values `toRow` produces.\n\nUpdate `docs/automation.md` with both columns and who fills each.\n\n### Why not have rtibblesbot judge it\n\nDetection of generated text is unreliable, and its errors fall hardest on people writing English as\na second language, who are a large share of our contributors. A wrong mark in a sheet the\ncontributor cannot see is one they can never correct.\n\nIf this is revisited, the judgment belongs on the pull request as a label, where it is visible,\ncontestable and reversible, and where the cron can read it from `pulls.get` with no new call. That\nis a separate decision, and it waits on evidence that false declarations actually happen.\n\n### Out of Scope\n\n- Detecting generated text automatically.\n- Making the #102 check required in branch protection, which is the lever that makes disclosure\n genuinely mandatory. That is a repo setting.\n- Changing which pull requests appear in the sheet.\n\n### Acceptance Criteria\n\n- [ ] Column I records whether the pull request discloses AI usage, filled by the daily run.\n- [ ] The parsing is shared with #102 rather than duplicated.\n- [ ] Column J is left untouched by the daily run, on both updated and appended rows.\n- [ ] The append range covers the new automated column.\n- [ ] Tests cover a filled section, an empty section, and a missing section.\n- [ ] `docs/automation.md` describes both columns and who fills each.\n\n### Testing\n\n1. Put a value in column J on an existing row in the test sheet.\n2. Run `Update community pull requests spreadsheet` against the test sheet. Expect column I to\n update, column J to survive, and the other columns to behave as before.\n3. Make sure that a newly appended row fills A to I and leaves J empty.\n\n### References\n\n- #102 enforces the pull request template, including the `## AI usage` section. The parsing belongs\n there, and this issue consumes it.\n- #101 moved the spreadsheet to a daily cron in this repo.\n\n## AI usage\n\nI used Claude Code to check how the spreadsheet writer handles columns, which showed that a hand\nfilled column needs no code change, and to find the overlap with #102. I decided the split between\nthe recorded disclosure and the maintainer's own mark.\n","author":{"url":"https://github.com/akolson","@type":"Person","name":"akolson"},"datePublished":"2026-10-01T07:58:45Z","url":"https://github.com/learningequality/.github/issues/108"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:a5e170f4-65b0-8fbe-cde9-62322d888345 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | AE74:9E1B2:235744F:2DFFC9A:6AFFEC60 |
| html-safe-nonce | a99db79abe31a069f8fc22aecc8f44f270ae5dec6e3566f6e0f37a6a252611b4 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBRTc0OjlFMUIyOjIzNTc0NEY6MkRGRkM5QTo2QUZGRUM2MCIsInZpc2l0b3JfaWQiOiIxODcxNTg4MzQyNDA4MTQ2MDE2IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | d60abd6390cf28732067f0b7dd02dceb52da91eb99ac76212f9e54c39a97eec5 |
| hovercard-subject-tag | issue:5658944195 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/learningequality/.github/108/issue_layout |
| twitter:image | https://opengraph.githubassets.com/fc35766edf18a41c89acead979094eec3bba31d7e98a641eba001f7f08cc5182/learningequality/.github/issues/108 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/fc35766edf18a41c89acead979094eec3bba31d7e98a641eba001f7f08cc5182/learningequality/.github/issues/108 |
| og:image:alt | Overview The contributions sheet records every community pull request, but not what the contributor said about their use of AI. Reviewers are reading that out of each pull request by hand. Add a co... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | akolson |
| hostname | github.com |
| expected-hostname | github.com |
| None | 0a0d8686a27478df474dd7415776a7a080cde8838b3cd92ea7601187572e5729 |
| turbo-cache-control | no-preview |
| go-import | github.com/learningequality/.github git https://github.com/learningequality/.github.git |
| octolytics-dimension-user_id | 3926525 |
| octolytics-dimension-user_login | learningequality |
| octolytics-dimension-repository_id | 647407699 |
| octolytics-dimension-repository_nwo | learningequality/.github |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 647407699 |
| octolytics-dimension-repository_network_root_nwo | learningequality/.github |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 16a11879678aaf97e2a42c33ee70830aa084fa37 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width