Hi all, @dimas-b suggested bringing PR #4368 to this list for visibility. The PR adds a pointer from README.md to the auto-generated Code Wiki for Apache Polaris (https://codewiki.google/github.com/apache/polaris), framed as a third-party navigation aid rather than an authoritative reference.
Feedback on the PR surfaced a structural question worth discussing here: - The Code Wiki is 100% AI-generated, and the project cannot review or control its content. @snazy's concern (paraphrased): if we point to it from our own docs, we are endorsing content we can't fully trust; it may also drift from the codebase version. His counter-proposal is to invest in more in-tree READMEs that the project reviews and versions. - @dimas-b raised a middle path: share the Code Wiki idea via a personal blog post rather than a direct link from CONTRIBUTING.md. The question for the list: what posture do we want the project to take toward AI-generated external references like this? A. Link with clear caveats (current PR, narrowed to README only). B. Don't link from project docs; share via personal blog post. C. Don't link externally; invest in reviewed in-tree README expansion instead. D. Name your better ideas! Please share your thoughts over ML thread here or PR: https://github.com/apache/polaris/pull/4368 Thanks, -ej
