[jwrosewell]

What changed and why

The configuration page has moved from configure.51degrees.com to https://51degrees.com/configure. The links and mentions that people read (READMEs, code comments, example output, and the messages that tell someone where to create a Resource Key) now use the new address, and the text that names the page calls it the configuration page.

• https://configure.51degrees.com/<code>?<query> became https://51degrees.com/configure/<code>?<query>, with each key, sharing code, path, trailing slash and query kept exactly as written.
• Where a line names the page in words, "configurator" became "configuration page" (the four README lines that link to it, three lines of AGENTS.md and the Javadoc of the minimal example). The section "Wording" below lists each sentence.
• No version number, workflow, code identifier, settings key or file name changed.
• 48 lines in 33 files changed (the comparison with rc shows 48 additions and 48 deletions in 33 files, over 3 commits).

The occurrences in code are constants and strings that are only written into messages telling a person where to create a Resource Key (the cloud request engine's error messages, the examples' output, and the test helpers that explain a missing key), and one Javadoc line.

Files and line counts

File	Lines
AGENTS.md	4
README.md	1
device-detection/README.md	1
device-detection/device-detection/src/main/java/fiftyone/devicedetection/DeviceDetectionPipelineBuilder.java	1
examples/device-detection/README.md	2
examples/device-detection/console/src/main/java/fiftyone/devicedetection/examples/console/GettingStartedCloud.java	1
examples/device-detection/console/src/main/java/fiftyone/devicedetection/examples/console/MinimalExample.java	1
examples/device-detection/console/src/main/java/fiftyone/devicedetection/examples/console/NativeModelCloud.java	1
examples/device-detection/console/src/main/java/fiftyone/devicedetection/examples/console/TacCloud.java	2
examples/device-detection/console/src/main/resources/tacCloud.xml	1
examples/device-detection/shared/src/main/java/fiftyone/devicedetection/examples/shared/KeyHelper.java	3
examples/device-detection/shared/src/main/java/fiftyone/devicedetection/examples/shared/settings.xml	1
examples/device-detection/shared/src/test/resources/51Degrees-Cloud-Test.xml	1
examples/device-detection/web/getting-started.cloud/src/main/java/fiftyone/devicedetection/examples/web/GettingStartedWebCloud.java	1
examples/device-detection/web/getting-started.cloud/src/main/webapp/WEB-INF/51Degrees-Cloud.xml	1
examples/ip-intelligence/README.md	2
examples/ip-intelligence/shared/src/main/java/fiftyone/ipintelligence/examples/shared/KeyHelper.java	3
examples/ip-intelligence/shared/src/main/java/fiftyone/ipintelligence/examples/shared/settings.xml	2
examples/ip-intelligence/shared/src/test/resources/51Degrees-Cloud-Test.xml	1
ip-intelligence/README.md	1
ip-intelligence/ip-intelligence/src/main/java/fiftyone/ipintelligence/IPIntelligencePipelineBuilder.java	1
location/README.md	1
location/geo-location.shell.examples/src/main/java/fiftyone/geolocation/examples/CombiningServices.java	2
location/geo-location.shell.examples/src/main/java/fiftyone/geolocation/examples/cloud/GettingStarted.java	2
location/geo-location.web.examples/geo-location.web.examples.mvc/src/main/webapp/WEB-INF/51Degrees-Cloud.xml	1
location/geo-location.web.examples/geo-location.web.examples.servlet/src/main/webapp/WEB-INF/51Degrees-Cloud.xml	1
location/geo-location/src/main/java/fiftyone/geolocation/GeoLocationPipelineBuilder.java	2
pipeline/pipeline.cloudrequestengine/src/main/java/fiftyone/pipeline/cloudrequestengine/Constants.java	1
pipeline/pipeline.cloudrequestengine/src/test/java/fiftyone/pipeline/cloudrequestengine/flowelements/CloudRequestEngineLiveTests.java	1
pipeline/pipeline.cloudrequestengine/src/test/java/fiftyone/pipeline/cloudrequestengine/flowelements/LiveCloudKeys.java	1
pipeline/pipeline.core/src/test/resources/options-test.xml	1
pipeline/pipeline.developer-examples/pipeline.developer-examples.cloud-engine/src/test/java/pipeline/developerexamples/cloudengine/ExampleTests.java	1
pipeline/pipeline.did/src/test/java/fiftyone/pipeline/did/LiveCloudKeys.java	2

Wording

Every line that names the page in words now calls it the "configuration page". Code identifiers, file and folder names, settings keys and documentation page addresses are unchanged.

Each changed sentence

• device-detection/README.md line 25: "our configuration page, see our [documentation](https://51degrees.com/documentation/_services__configurator.ht"
• examples/device-detection/README.md line 43: "our configuration page, see our [documentation](https://51degrees.com/documentation/_services__configurator.ht"
• ip-intelligence/README.md line 27: "our configuration page, see our [documentation](https://51degrees.com/documentation/_services__configurator.ht"
• location/README.md line 21: "configuration page, see our"
• AGENTS.md lines 173 to 175 (commit ec70ce2): "The cloud examples need a resource key, which a person creates on the configuration page, so ask for one if none is set. A key with the properties most of the Device Detection examples use can be made"
• examples/device-detection/console/src/main/java/fiftyone/devicedetection/examples/console/MinimalExample.java line 31 (commit ec70ce2): "This is the code for the minimal example displayed on the configuration page."

Base branch

rc, because recent changes to this repository were merged into rc (for example #113 and #111) and reach main in a release pull request.

Campaign tags

No campaign tag was added, removed or changed. The shared campaign tag lint (scripts/utm-lint.ps1 in common-ci) applies the same rules to configure.51degrees.com and 51degrees.com, so every link that was tagged keeps its five parameters and every link that was untagged was in a file the lint does not check (test folders) and stays untagged.

What was left alone

No occurrence of the old address remains on this branch, and no line names the page as the configurator. A search of the head for "configurator", ignoring case and leaving out the cxx and owid-java submodules, finds only two kinds of line, neither of them a name for the page.

• The documentation page addresses https://51degrees.com/documentation/_services__configurator.html in the four READMEs, which are the addresses of pages on 51degrees.com and so cannot change here.
• Logback's JoranConfigurator and the configurator variables that hold it in pipeline/pipeline.common/src/main/java/fiftyone/common/testhelpers/LogbackHelper.java, being the import at line 27 and lines 90 to 129.

How it was checked

• A search of every file on rc for configure.51degrees.com, ignoring case, found 44 lines in 32 files. The same search on this branch finds none.
• Each occurrence outside Markdown and comments was read in place to confirm it is text shown to a person and not a value the code calls or compares against a reply from the cloud service.
• No build or test was run locally. The checks on this pull request run the tests and the campaign tag lint.
• On 13 November at 22:55 UTC https://51degrees.com/configure answered 200 with the page title "Cloud Configuration | 51Degrees", and so did a changed link with a sharing code, https://51degrees.com/configure/QKyYH5XT with its campaign tags. The page then ticks the properties of a sharing code with its own script, which a browser shows and a request on its own cannot.
• rc was merged in at 242f634 and again at 2992a87 (rc at 6e03a25), each with a merge commit and without conflict. A trial merge with rc at ceab088 on 14 November at 09:30 UTC was also clean.
• Full build. Run 43558552650 built ec70ce2 merged with rc (6e03a25) on nine configurations, Ubuntu x64 with Java 8, 11, 17 and 21, Ubuntu arm64 with Java 17, and Windows with Java 8, 11, 17 and 21, and every job passed. Each of its ten Setting 'PullRequestSha' lines names ec70ce2, and its Configure job printed "Left out 6 macOS entries".
• macOS was left out of this draft's full build under the 9 November decision. The rc head is built with macOS before it merges into main.