You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@polaris.apache.org by "flyingImer (via GitHub)" <gi...@apache.org> on 2026/09/23 05:00:07 UTC
[PR] [PoC] docs: add a tool to archive Google Docs proposal revisions [polaris]
flyingImer opened a new pull request, #5587:
URL: https://github.com/apache/polaris/pull/5587
Authors who draft proposals in Google Docs need a way to preserve specific versions in the repository so implementation PRs can reference them.
This PoC follows the [proposal-docs discussion](https://lists.apache.org/thread/yto2wp982t43h1mqjwnslswhws5z47cy). It adds a capture tool, an optional local build command, and CI automation, with the Tag proposal as a working example.
An owner adds a version and an ordinary Google Doc link to one `proposals/<name>/manifest.yaml`:
```
proposal: my-proposal
revisions:
rev1:
google_doc_url: https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit
```
`make proposal-snapshots` captures the document and fills the Google revision and relative snapshot paths into that same entry. Owners can preview locally. If they push the pending entry, CI in their fork generates the files and commits them back to the branch. Upstream PR checks validate the committed snapshots offline.
A pending version captures the Doc when the build runs. Once captured, it stays frozen. Later builds verify the archived bytes, and another capture requires a new version entry. Each snapshot includes Markdown, supported images as local assets, and provenance metadata.
The current anonymous importer requires **Anyone with the link and Editor access**. Generated content still needs review for fidelity. Comments are not archived, and discussion summaries and decisions still belong on the dev list.
## Validation:
- The [Tag example CI run](https://github.com/flyingImer/polaris/actions/runs/35818121693) resolved a pending entry, reused its existing snapshot, and committed the completed manifest.
- [./gradlew format compileAll rat](https://github.com/flyingImer/polaris/actions/runs/35818335698) passed, with no formatting changes.
This is a tool for community evaluation. Including the Tag snapshot does not imply acceptance of that proposal.
## Checklist
- [x] ๐ก๏ธ Don't disclose security issues! (contact security@apache.org)
- [x] ๐ Clearly explained why the changes are needed, or linked related issues: Fixes #
- [x] ๐งช Added/updated tests with good coverage, or manually tested (and explained how)
- [x] ๐ก Added comments for complex logic
- [ ] ๐งพ Updated `CHANGELOG.md` (if needed)
- [ ] ๐ Updated documentation in `site/content/in-dev/unreleased` (if needed)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [PoC] docs: add a tool to archive Google Docs proposal revisions [polaris]
Posted by "github-actions[bot] (via GitHub) via issues" <is...@polaris.apache.org>.
github-actions[bot] closed pull request #5587: [PoC] docs: add a tool to archive Google Docs proposal revisions
URL: https://github.com/apache/polaris/pull/5587
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [PoC] docs: add a tool to archive Google Docs proposal revisions [polaris]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on PR #5587:
URL: https://github.com/apache/polaris/pull/5587#issuecomment-6485393927
This PR is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 5 days.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [PoC] docs: add a tool to archive Google Docs proposal revisions [polaris]
Posted by "flyingImer (via GitHub)" <gi...@apache.org>.
flyingImer commented on PR #5587:
URL: https://github.com/apache/polaris/pull/5587#issuecomment-5876508848
> Thanks for this proposal, @flyingImer !
>
> I think it can be very useful for people how prefer gDoc or already have WIP proposals written in gDoc ๐
>
> Minor request: Would you mind splitting actual tool code and the tag doc it produced into separate (dependent) PRs?.. just for ease of the code / doc review.
@dimas-b totally! This is just a POC to showcase how them work together and get early feedback. Definitely, I will separate them out before actually merging in
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org