Say which SDKs provide the robots.txt engine - #234
Open
jwrosewell wants to merge 1 commit into
Open
Conversation
The page named the .NET package once in passing and never said the on-premise engine is .NET only. A developer working in Java could read the whole page, see a package they cannot use, and not learn that the Cloud route works from their language today. Verified against the code before writing it: RobotsTxtEngine appears only in C# across the organisation, with no occurrences in Java, C, C++, Go, Rust, PHP, Node or Python. Found because our website assistant could not answer 'is this available in Java'. It correctly refused to guess, which was the right behaviour and showed the gap: nothing published states which SDKs have the feature.
Contributor
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.
The Robots.txt Generator page names the .NET package once in passing and never states that the on-premise engine is .NET only. A developer working in Java can read the whole page, see a package they cannot use, and never learn that the Cloud route works from their language today.
This adds an Availability section near the top saying so plainly, with a table covering the three ways to use the feature.
Checked against the code, not assumed
RobotsTxtEngineappears only in C# across the 51Degrees organisation. A code search returns 7 occurrences in C# and zero in Java, C, C++, Go, Rust, PHP, Node and Python. The files areFiftyOne.DeviceDetection.RobotsTxt/FlowElements/RobotsTxtEngine.csandRobotsTxtBuilder.csin device-detection-dotnet.How this was found
Our website assistant was asked whether the robots.txt engine is available in Java. It declined to answer rather than guess, which was correct, and that is what exposed the gap: nothing published anywhere states which SDKs provide the feature, so neither a reader nor an assistant can tell.
That suggests a wider check is worth doing, comparing what exists in the repositories against what the documentation says exists per language. This PR fixes the one case we hit.
Note on how this was written
Drafted with AI assistance. The availability claim was verified against the code before writing, but the wording should have a human read before merge.