Correct TGP documentation and remove legal framing#18
Merged
Conversation
magiccodingman
marked this pull request as ready for review
July 25, 2026 20:01
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.
What changed
This PR corrects the TGP documentation after separating what IPNS and Kubo already provide from what TGP uniquely adds.
Removes legal positioning
docs/tgp/legal-considerations.mddocs/tgp/legal-notice-template.mdlegalfield andlegal.mdfile from the normative v1 documentation examplesThe remaining limitation language is purely technical: changing a pointer does not remove older CIDs, local removal requires handling every retaining pin/reference and Kubo garbage collection, and third parties may retain copies independently.
Corrects the relationship with IPNS
The documentation now says explicitly that:
Strengthens TGP's actual rationale
The primary model is now described as a deliberate trade:
The additional hop provides:
index.htmlresolver/fallback for ordinary and IPFS-aware browsersClarifies retention policy
TGP's retention benefit is now framed as organizational and operational, not a new IPFS capability.
TGP supplies a stable control boundary around which a publisher can express, automate, monitor, and eventually verify a retention policy. Kubo still performs the actual pin and repository operations.
The publisher guide now distinguishes pointer publication from content retention and lists the pins, MFS references, watched-IPNS policies, archives, remote pinning services, and garbage collection that a complete implementation must consider.
Expands browser fallback documentation
The docs now recognize the TGP root as a useful user-facing location, not merely a JSON holder. They describe how a browser helper may:
Scope
This PR is documentation-only.
It intentionally does not change:
TgpTemplateslegal.mdlegalJSON propertyPublishQueueThe generated runtime notice and the previously identified publish-retention question should be reviewed separately after this documentation correction is approved, so protocol/runtime behavior is not silently mixed into a docs PR.
Diff