Repository navigation
Use the reserved example.com domain in examples and tests - #15
Merged
Merged
Conversation
company.com is a registered domain that belongs to a real company. RFC 2606 reserves example.com for documentation, so the login prompt, the error hint, the documentation, and the test data now use tfs.example.com. The archived tasks file keeps its original text. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Te5mNQhPPc8k9Bm7GpKPx7
Archived tasks files are kept as a record of the work and are not normally edited. This change is a deliberate exception: it does not alter what the plan said or decided, it only replaces a third-party domain used as an example URL with the reserved example.com (RFC 2606), as the previous commit did everywhere else. With it, the repository no longer refers to company.com anywhere. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Te5mNQhPPc8k9Bm7GpKPx7
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
1 participant
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.
Problem
Example URLs throughout the repository used
company.com, a registered domain that belongs to a real company. The domain appeared in documentation, in test data, and in strings compiled into the binary: the server URL prompt oftfscli auth loginand the example in the error for a URL that contains credentials.Approach
RFC 2606 reserves
example.comfor documentation and examples, sotfs.company.combecomestfs.example.comandshop.company.combecomesshop.example.com. Ports, paths, and the overall URL shape stay the same, because they illustrate the typical on-premises TFS address. The reserved.exampletop-level domain was considered and rejected:tfs.example.comreads as a realistic corporate address, which makes it the clearer example.Notes
CHANGELOG.mdentry.docs/archive/2026-10-01-tasks-login-api-version.md. Archived tasks files are normally kept unedited as a record of the work. This edit is a deliberate exception: it replaces only the third-party domain and leaves the plan's content and decisions intact. It is a separate commit so that the exception stays visible in the history.Testing
make checkpasses after the first commit. The second commit changes one line in an archived Markdown file that the build and tests do not read.rg 'company\.com'finds no matches in the repository.