docs(launch): add maintainer install and trust guide - #481
Merged
JSONbored merged 6 commits intoJun 10, 2026
Merged
Conversation
Contributor
|
Superagent didn't find any vulnerabilities or security issues in this PR. |
|
Note Gittensory Gate skippedPR closed before full evaluation. No late first comment was created.
Checked by Gittensory, a quiet PR intelligence layer for OSS maintainers. |
JSONbored
requested changes
Jun 8, 2026
JSONbored
left a comment
Owner
There was a problem hiding this comment.
@jonathanchang31 the guide topic is useful, but this branch needs cleanup before it can merge.
A few notes:
- This is visible docs work, so the screenshot evidence belongs in the PR description as GitHub-hosted JPG/PNG evidence, not as a committed review-only file.
- package-lock.json and worker-configuration.d.ts are unrelated churn for a docs route unless there is a concrete generated-artifact reason, and the PR does not establish that.
- The docs route/nav/sitemap shape is otherwise in the right area.
Required changes:
- Remove docs/evidence/issue-253-maintainer-install-trust-guide.png from the repository.
- Move the required visual evidence into the PR body under a clear UI Evidence or Screenshots section.
- Revert unrelated package-lock.json and worker-configuration.d.ts changes unless they are directly required and explained.
- Re-run the docs/UI validation that covers routeTree, sitemap, nav, lint, typecheck, and build.
Validation expected:
- git diff --check
- ui:lint
- ui:typecheck
- ui:build
- route/sitemap generation check if this repo has a dedicated command for it
Contributor
Author
|
@JSONbored Could you review my PR? |
JSONbored
self-requested a review
June 10, 2026 17:11
JSONbored
approved these changes
Jun 10, 2026
JSONbored
left a comment
Owner
There was a problem hiding this comment.
@jonathanchang31 this is good to land.
A few notes:
- The previous blockers are fixed: the committed review-only evidence and unrelated generated/package churn are gone.
- The route, nav, sitemap, and generated route metadata are aligned.
- The public/private-boundary wording is acceptable here because it tells maintainers what must not appear in public output; it does not expose actual identifiers, private packets, or optimization tactics.
- Screenshot formatting could be better as clickable thumbnails with captions, but the required evidence is present.
No code changes requested.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a maintainer-facing launch guide for installing and trusting Gittensory in a repository. The new guide documents GitHub App setup, maintainer controls, command authorization, public-safe previews, browser extension states, audit expectations, CI/check separation from human reviewer approval, and criteria for rejecting weak Gittensory-driven PRs.
Related Issue
Closes: #253
Change Type
Real Behavior Proof
Validated locally with the built UI worker:
Checklist
UI Evidence