diff --git a/services/amo/amo.service.js b/services/amo/amo.service.js
index da123461f6f74d704d6fd539f33cd5d108e303ac..0c2822c3be84e7fa9f34bc3cef2f76c3381e51e3 100644
--- a/services/amo/amo.service.js
+++ b/services/amo/amo.service.js
@@ -150,6 +150,12 @@ class AmoUsers extends LegacyService {
   static registerLegacyRouteHandler() {}
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class Amo extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/bintray/bintray.service.js b/services/bintray/bintray.service.js
index 5ef5db57d9522747106253350cb9c70aa6c18a8d..1862b36feeaa845f92c60799729625a14d77ef90 100644
--- a/services/bintray/bintray.service.js
+++ b/services/bintray/bintray.service.js
@@ -6,6 +6,12 @@ const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 const serverSecrets = require('../../lib/server-secrets')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Bintray extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/bitrise/bitrise.service.js b/services/bitrise/bitrise.service.js
index 874fba7375f00cc549a83fe27a56d5d53c1bfe4b..0c6a1242eddcda27059565baabbffd42c72f2dac 100644
--- a/services/bitrise/bitrise.service.js
+++ b/services/bitrise/bitrise.service.js
@@ -3,6 +3,12 @@
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Bitrise extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/bower/bower-license.service.js b/services/bower/bower-license.service.js
index 4d88b7ffe95796511d8c15e46adb7c589ecb5043..b3cbe261fdfab4171aac62433f88e9079c63ea4f 100644
--- a/services/bower/bower-license.service.js
+++ b/services/bower/bower-license.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const serverSecrets = require('../../lib/server-secrets')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class BowerLicense extends LegacyService {
   static get category() {
     return 'license'
diff --git a/services/bower/bower-version.service.js b/services/bower/bower-version.service.js
index 9987b4b9f690d358186fb8b3f30be3c9f1844e28..209e7b99c4697c650d32e01e9fe2f090ae5a4081 100644
--- a/services/bower/bower-version.service.js
+++ b/services/bower/bower-version.service.js
@@ -6,6 +6,12 @@ const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 const serverSecrets = require('../../lib/server-secrets')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class BowerVersion extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/bugzilla/bugzilla.service.js b/services/bugzilla/bugzilla.service.js
index ec4e8b7249e69acd28156e1d5efda5aa971af539..077ab09c735137eff09720401fc3f46ea2b2a8ae 100644
--- a/services/bugzilla/bugzilla.service.js
+++ b/services/bugzilla/bugzilla.service.js
@@ -10,6 +10,12 @@ const documentation = `
 </p>
 `
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Bugzilla extends LegacyService {
   static get category() {
     return 'issue-tracking'
diff --git a/services/buildkite/buildkite.service.js b/services/buildkite/buildkite.service.js
index 627f814b19fd1ea9d02df50e61ded059b091c6ef..f51cb41392df54b1e058a175945891161702c8f2 100644
--- a/services/buildkite/buildkite.service.js
+++ b/services/buildkite/buildkite.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { checkErrorResponse } = require('../../lib/error-helper')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Buildkite extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/bundlephobia/bundlephobia.service.js b/services/bundlephobia/bundlephobia.service.js
index ba0bb8d3811e0d9bcaf00c8817e275aaa5471251..164f7c5f0e0a56e8c62ffcac7cdeb0bf61e7f128 100644
--- a/services/bundlephobia/bundlephobia.service.js
+++ b/services/bundlephobia/bundlephobia.service.js
@@ -4,7 +4,12 @@ const prettyBytes = require('pretty-bytes')
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
-// Bundle size for npm packages.
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Bundlephobia extends LegacyService {
   static get category() {
     return 'size'
diff --git a/services/chrome-web-store/chrome-web-store.service.js b/services/chrome-web-store/chrome-web-store.service.js
index 1a1e748cdd4c52c9b5859ace55bc12d043974008..916e20a8fe9d3e25f6e968a080f0bd43a7904673 100644
--- a/services/chrome-web-store/chrome-web-store.service.js
+++ b/services/chrome-web-store/chrome-web-store.service.js
@@ -137,6 +137,12 @@ class ChromeWebStoreRating extends LegacyService {
   static registerLegacyRouteHandler() {}
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class ChromeWebStore extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/cocoapods/cocoapods-apps.service.js b/services/cocoapods/cocoapods-apps.service.js
index f4e63588f691df71b53fed16cd774cee6c853975..2d21098ade5378d0f1135688be605d2092d8e678 100644
--- a/services/cocoapods/cocoapods-apps.service.js
+++ b/services/cocoapods/cocoapods-apps.service.js
@@ -8,6 +8,12 @@ const {
   downloadCount: downloadCountColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class CocoapodsApps extends LegacyService {
   static get category() {
     return 'other'
diff --git a/services/cocoapods/cocoapods-downloads.service.js b/services/cocoapods/cocoapods-downloads.service.js
index 2a3d71061ebd99fdf9681a3e3a2c13725008584a..80387e5da15f2f2d8c84d503914b3994bf22bead 100644
--- a/services/cocoapods/cocoapods-downloads.service.js
+++ b/services/cocoapods/cocoapods-downloads.service.js
@@ -8,6 +8,12 @@ const {
   downloadCount: downloadCountColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class CocoapodsDownloads extends LegacyService {
   static get category() {
     return 'downloads'
diff --git a/services/cocoapods/cocoapods-metrics.service.js b/services/cocoapods/cocoapods-metrics.service.js
index 2c9c0e63ea1628a8e8964ae2bf51f5b860ca5b93..f9fcdfc1a9ae936f426c5790677b5e55628f3d4b 100644
--- a/services/cocoapods/cocoapods-metrics.service.js
+++ b/services/cocoapods/cocoapods-metrics.service.js
@@ -7,6 +7,12 @@ const {
   coveragePercentage: coveragePercentageColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class CocoapodsMetrics extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/cocoapods/cocoapods.service.js b/services/cocoapods/cocoapods.service.js
index c8fff7913cf24868ba471156af4b23c949dd2972..147e0f347ec10b8a6dcbdcf94eb2fe334f50a528 100644
--- a/services/cocoapods/cocoapods.service.js
+++ b/services/cocoapods/cocoapods.service.js
@@ -6,6 +6,12 @@ const { checkErrorResponse } = require('../../lib/error-helper')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class CocoapodsVersionPlatformLicense extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/codeclimate/codeclimate.service.js b/services/codeclimate/codeclimate.service.js
index e7f7b9483ce62a018ffbb338156a185ee6a499d3..27d05ea26254f5dcf790dc8ea6be02273443954b 100644
--- a/services/codeclimate/codeclimate.service.js
+++ b/services/codeclimate/codeclimate.service.js
@@ -8,6 +8,12 @@ const {
   colorScale,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Codeclimate extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/codecov/codecov.service.js b/services/codecov/codecov.service.js
index 91c6865970f1b5a5e75645a5a91138c01f8ffb55..50b7cdc1b61dad0c88ae0fabcb96620cc81e158c 100644
--- a/services/codecov/codecov.service.js
+++ b/services/codecov/codecov.service.js
@@ -7,6 +7,12 @@ const {
   coveragePercentage: coveragePercentageColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Codecov extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/codeship/codeship.service.js b/services/codeship/codeship.service.js
index 7db76356dcf877680c43ffeef0c0bb885a387c37..e1e884f923b16e1eb4351daa90bd832686f85e11 100644
--- a/services/codeship/codeship.service.js
+++ b/services/codeship/codeship.service.js
@@ -3,6 +3,12 @@
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Codeship extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/continuousphp/continuousphp.service.js b/services/continuousphp/continuousphp.service.js
index f6c2528aa464f11036e4bf6bc3737ccf3e1457ce..5ab44ad6db7677837983bf17b6f961d8b4076f4c 100644
--- a/services/continuousphp/continuousphp.service.js
+++ b/services/continuousphp/continuousphp.service.js
@@ -3,6 +3,12 @@
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class ContinuousPhp extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/cookbook/cookbook.service.js b/services/cookbook/cookbook.service.js
index b0556ba7960e170698c929edb7d35704a7ee1376..e745e864f2d4690374084c96eb6d5df2a75d45bd 100644
--- a/services/cookbook/cookbook.service.js
+++ b/services/cookbook/cookbook.service.js
@@ -6,6 +6,13 @@ const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
 // For Chef cookbook.
+//
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Cookbook extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/coveralls/coveralls.service.js b/services/coveralls/coveralls.service.js
index ac27e30865fdf115b4704b544ad2e7d1fe5858ce..3d221d541c9622e509dac25613704b08216bcdf7 100644
--- a/services/coveralls/coveralls.service.js
+++ b/services/coveralls/coveralls.service.js
@@ -6,6 +6,12 @@ const {
   coveragePercentage: coveragePercentageColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Coveralls extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/coverity/coverity-on-demand.service.js b/services/coverity/coverity-on-demand.service.js
index ebb19a35030f29f655134d298c7bc7ebc01337b5..ea6217d02c252b9830e42b76e1b5adce3fd73a1f 100644
--- a/services/coverity/coverity-on-demand.service.js
+++ b/services/coverity/coverity-on-demand.service.js
@@ -4,6 +4,13 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
 // For Coverity Code Advisor On Demand.
+//
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class CoverityOnDemand extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/coverity/coverity-scan.service.js b/services/coverity/coverity-scan.service.js
index 68f9ed6df7cd119dfb723d4fa24e3d9b494c4dda..3ca687ebc97655cf858363f94317881b910d1aad 100644
--- a/services/coverity/coverity-scan.service.js
+++ b/services/coverity/coverity-scan.service.js
@@ -3,6 +3,12 @@
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class CoverityScan extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/cpan/cpan.service.js b/services/cpan/cpan.service.js
index e2e97eaa4dde59bb9f38da577c44cb49f5cb761c..7b265fda950fa582c82af81e5ddb96f2f309ca49 100644
--- a/services/cpan/cpan.service.js
+++ b/services/cpan/cpan.service.js
@@ -5,6 +5,12 @@ const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Cpan extends LegacyService {
   static get route() {
     return { base: 'cpan' }
diff --git a/services/david/david.service.js b/services/david/david.service.js
index ce41521058ed1c7995613ee98cbb49a5dcb41824..5ae15c5e963794b1809f260f5d6d82c164c7edf0 100644
--- a/services/david/david.service.js
+++ b/services/david/david.service.js
@@ -3,6 +3,12 @@
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class David extends LegacyService {
   static get category() {
     return 'dependencies'
diff --git a/services/discourse/discourse.service.js b/services/discourse/discourse.service.js
index 4d9e079933d76965bfebf7f0d7767cb0c7d65371..d2b867556e4b01895596ed51dbabb49343ce2166 100644
--- a/services/discourse/discourse.service.js
+++ b/services/discourse/discourse.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { metric } = require('../../lib/text-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Discourse extends LegacyService {
   static get category() {
     return 'chat'
diff --git a/services/dub/dub-download.service.js b/services/dub/dub-download.service.js
index c92fb65039ab3e9a014e0e38844497f7e039228a..0b76d6b99c04c0c3d5ac5b50ce480d7e717400a2 100644
--- a/services/dub/dub-download.service.js
+++ b/services/dub/dub-download.service.js
@@ -12,6 +12,12 @@ const {
   downloadCount: downloadCountColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class DubDownload extends LegacyService {
   static get category() {
     return 'downloads'
diff --git a/services/dub/dub-license-version.service.js b/services/dub/dub-license-version.service.js
index 5c0c8967f1765fbd9d0f25b0e7528e6e0caa80b2..587db9f4870651ffbd322a5486723956174644e5 100644
--- a/services/dub/dub-license-version.service.js
+++ b/services/dub/dub-license-version.service.js
@@ -59,6 +59,12 @@ class DubLicense extends LegacyService {
   static registerLegacyRouteHandler() {}
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class DubLicenseVersion extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/github/github-commit-activity.service.js b/services/github/github-commit-activity.service.js
index 11dd3e27427c3c0e8029b8e8ef934911e13f8775..2c2bef12fcb808a8f0d177a9b36894586406c422 100644
--- a/services/github/github-commit-activity.service.js
+++ b/services/github/github-commit-activity.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubCommitActivity extends LegacyService {
   static get category() {
     return 'activity'
diff --git a/services/github/github-commit-status.service.js b/services/github/github-commit-status.service.js
index 0838f2962df25b2cc9b3befda77add868834f4e1..7001345a88a8f6eaa46f44f0ba03bfe7ad32b07a 100644
--- a/services/github/github-commit-status.service.js
+++ b/services/github/github-commit-status.service.js
@@ -7,6 +7,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubCommitStatus extends LegacyService {
   static get category() {
     return 'issue-tracking'
diff --git a/services/github/github-commits-since.service.js b/services/github/github-commits-since.service.js
index b2ef6f069de28a4de0bcebf2b1cdb7e19688678d..1f064a2ab0ff6243f5b53e273f231b64a73511da 100644
--- a/services/github/github-commits-since.service.js
+++ b/services/github/github-commits-since.service.js
@@ -10,6 +10,12 @@ const { documentation } = require('./github-helpers')
 
 const keywords = ['GitHub', 'commit']
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubCommitsSince extends LegacyService {
   static get category() {
     return 'activity'
diff --git a/services/github/github-contributors.service.js b/services/github/github-contributors.service.js
index aa184a7dc7f4d11cb2d5d6e19cac5f1ebdb36685..3e48157c93e02dd2d39e9dd7dac321bdc120af0f 100644
--- a/services/github/github-contributors.service.js
+++ b/services/github/github-contributors.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubContributors extends LegacyService {
   static get category() {
     return 'activity'
diff --git a/services/github/github-downloads.service.js b/services/github/github-downloads.service.js
index 3b7bbbacaaa9c330f4a8a0e7b5508e5651776029..15b1808d1701b014c66f504a428b24e9cbf37096 100644
--- a/services/github/github-downloads.service.js
+++ b/services/github/github-downloads.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubDownloads extends LegacyService {
   static get category() {
     return 'downloads'
diff --git a/services/github/github-followers.service.js b/services/github/github-followers.service.js
index a813d8e9e184bf058f68c13f661324edcdb03963..de996ee14e12e3002cb65811d8f715051dc103c9 100644
--- a/services/github/github-followers.service.js
+++ b/services/github/github-followers.service.js
@@ -10,6 +10,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubFollowers extends LegacyService {
   static get category() {
     return 'social'
diff --git a/services/github/github-forks.service.js b/services/github/github-forks.service.js
index d7800820a303e5a2245425d67307b5a14f46e288..cb4dae45f0a4bf2179c13cadca7945b17bcee132 100644
--- a/services/github/github-forks.service.js
+++ b/services/github/github-forks.service.js
@@ -10,6 +10,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubForks extends LegacyService {
   static get category() {
     return 'social'
diff --git a/services/github/github-issue-detail.service.js b/services/github/github-issue-detail.service.js
index fbbddb0b331e316c8f0ebd23d380c788fb2452b1..65c6e82af328a0eca1808b5cb28488869e5f99f0 100644
--- a/services/github/github-issue-detail.service.js
+++ b/services/github/github-issue-detail.service.js
@@ -16,6 +16,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubIssueDetail extends LegacyService {
   static get category() {
     return 'issue-tracking'
diff --git a/services/github/github-issues.service.js b/services/github/github-issues.service.js
index 475b9012d470b99828995143703b8c6071f0ce56..adc7d9c42e1cff1c328162643ea0e35d835e9d7c 100644
--- a/services/github/github-issues.service.js
+++ b/services/github/github-issues.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubIssues extends LegacyService {
   static get category() {
     return 'issue-tracking'
diff --git a/services/github/github-languages.service.js b/services/github/github-languages.service.js
index d204970d9d93d9dce856bc7f0e0acdd5f92b0834..077748fa8e593173e4d6c233ded8648d05ee9fe4 100644
--- a/services/github/github-languages.service.js
+++ b/services/github/github-languages.service.js
@@ -12,6 +12,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class GithubCodeSize extends LegacyService {
   static get category() {
     return 'size'
diff --git a/services/github/github-last-commit.service.js b/services/github/github-last-commit.service.js
index a245aa4b1ecf2d9b7c3d04954e5e3a7a58aee722..f5fe474a3ef25109234338b274761c1eb788da3c 100644
--- a/services/github/github-last-commit.service.js
+++ b/services/github/github-last-commit.service.js
@@ -12,6 +12,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubLastCommit extends LegacyService {
   static get category() {
     return 'activity'
diff --git a/services/github/github-license.service.js b/services/github/github-license.service.js
index ce8103ec2d7b60520f4d73a2cb1bb568e35671ac..e89682a08f0f285f6cc2867043aa52aa1b1e746e 100644
--- a/services/github/github-license.service.js
+++ b/services/github/github-license.service.js
@@ -12,6 +12,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubLicense extends LegacyService {
   static get category() {
     return 'license'
diff --git a/services/github/github-manifest-version.service.js b/services/github/github-manifest-version.service.js
index 6d3aebc1810596292cfe43d6062d48f4add327d0..cd905e4c430301d86504dd5d6dc53c99c44ce531 100644
--- a/services/github/github-manifest-version.service.js
+++ b/services/github/github-manifest-version.service.js
@@ -12,6 +12,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubManifestVersion extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/github/github-release-date.service.js b/services/github/github-release-date.service.js
index 79b9c0f956f3e12a3b859acdbabf861a77e44216..7250089035f4fb44e48ba40feca07a0ccc564ef0 100644
--- a/services/github/github-release-date.service.js
+++ b/services/github/github-release-date.service.js
@@ -10,6 +10,12 @@ const { formatDate } = require('../../lib/text-formatters')
 const { age } = require('../../lib/color-formatters')
 const { documentation } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubReleaseDate extends LegacyService {
   static get category() {
     return 'activity'
diff --git a/services/github/github-release.service.js b/services/github/github-release.service.js
index 608488bd509eff32cc5397845794fe0935217003..7f95c2315e28e0bc58620ee3d2abd76563efe451 100644
--- a/services/github/github-release.service.js
+++ b/services/github/github-release.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubRelease extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/github/github-repo-size.service.js b/services/github/github-repo-size.service.js
index 089eced795658840db1f7890723a13f648c08344..64527c78e75f9bf0aef4a2ee535b379f64d95e00 100644
--- a/services/github/github-repo-size.service.js
+++ b/services/github/github-repo-size.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubRepoSize extends LegacyService {
   static get category() {
     return 'size'
diff --git a/services/github/github-search.service.js b/services/github/github-search.service.js
index 4bb20fb473390b4bcfc8f71dd94ed56c33f476ad..ce4d895ee4b84a399b5e6f980e1ec7a155ff7746 100644
--- a/services/github/github-search.service.js
+++ b/services/github/github-search.service.js
@@ -8,6 +8,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubSearch extends LegacyService {
   static get category() {
     return 'other'
diff --git a/services/github/github-size.service.js b/services/github/github-size.service.js
index 0b8dea75f3db0cb463d6fba62f2310f8fc0507ef..d532d172bb006b98ae024b7a47dceea25f934191 100644
--- a/services/github/github-size.service.js
+++ b/services/github/github-size.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubSize extends LegacyService {
   static get category() {
     return 'size'
diff --git a/services/github/github-stars.service.js b/services/github/github-stars.service.js
index 8460957c74b7a27587ad8232891f56a5123bb697..8daaf2e1259da8944ada9fb85d4d7b3853f8ddee 100644
--- a/services/github/github-stars.service.js
+++ b/services/github/github-stars.service.js
@@ -11,6 +11,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubStars extends LegacyService {
   static get category() {
     return 'social'
diff --git a/services/github/github-tag.service.js b/services/github/github-tag.service.js
index f6644fb694e074e568ecf4f50807d626d8d8f584..de64f50bd7c1fb75dba19f2cd0b1abe5322159e9 100644
--- a/services/github/github-tag.service.js
+++ b/services/github/github-tag.service.js
@@ -13,6 +13,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubTag extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/github/github-watchers.service.js b/services/github/github-watchers.service.js
index 7b7a178c30b315de28d7011321ea7e134e98ec71..52cee07e552f6ae891a47f7baef4463552a943c1 100644
--- a/services/github/github-watchers.service.js
+++ b/services/github/github-watchers.service.js
@@ -10,6 +10,12 @@ const {
   checkErrorResponse: githubCheckErrorResponse,
 } = require('./github-helpers')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class GithubWatchers extends LegacyService {
   static get category() {
     return 'social'
diff --git a/services/hackage/hackage-deps.service.js b/services/hackage/hackage-deps.service.js
index b886503da0f90b7d240649e5a83f172d45fae901..e851da42115f37e34658efe7c827bc83e7ec000f 100644
--- a/services/hackage/hackage-deps.service.js
+++ b/services/hackage/hackage-deps.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { checkErrorResponse } = require('../../lib/error-helper')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class HackageDeps extends LegacyService {
   static get category() {
     return 'dependencies'
diff --git a/services/hackage/hackage-version.service.js b/services/hackage/hackage-version.service.js
index 4b1fb8bf6f71d12e7206fa6d5f701d1211897a3c..1d0ea6be4d19ce80a7a618f7f81c816de03159a6 100644
--- a/services/hackage/hackage-version.service.js
+++ b/services/hackage/hackage-version.service.js
@@ -6,6 +6,12 @@ const { checkErrorResponse } = require('../../lib/error-helper')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class HackageVersion extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/homebrew/homebrew.service.js b/services/homebrew/homebrew.service.js
index ddb94ab31f2899ee63b94b99341bfcc8a6e9339e..ba3b8d2d0f30fd5efd8f146a2fb368140207c431 100644
--- a/services/homebrew/homebrew.service.js
+++ b/services/homebrew/homebrew.service.js
@@ -6,6 +6,12 @@ const { checkErrorResponse } = require('../../lib/error-helper')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Homebrew extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/itunes/itunes.service.js b/services/itunes/itunes.service.js
index d2b5698e90d533bea4a1d4631d187a407de87b10..cc219bc08903e9b807b65a4401022a7d7611fb44 100644
--- a/services/itunes/itunes.service.js
+++ b/services/itunes/itunes.service.js
@@ -5,6 +5,12 @@ const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Itunes extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/jenkins/jenkins-build.service.js b/services/jenkins/jenkins-build.service.js
index 310125edf5e7705b0fa66cb055be758d3c27e59b..76e71b3b793d42e97b49c4baa4e3af487fe5c2cc 100644
--- a/services/jenkins/jenkins-build.service.js
+++ b/services/jenkins/jenkins-build.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const serverSecrets = require('../../lib/server-secrets')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class JenkinsBuild extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/jenkins/jenkins-plugin-version.service.js b/services/jenkins/jenkins-plugin-version.service.js
index 7fa3d96009a74202949880e92423f874eb058f62..1579a6b9b29e961bd819696044a9e5513ccdb81f 100644
--- a/services/jenkins/jenkins-plugin-version.service.js
+++ b/services/jenkins/jenkins-plugin-version.service.js
@@ -6,6 +6,12 @@ const { regularUpdate } = require('../../lib/regular-update')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class JenkinsPlugin extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/jenkins/jenkins-tests.service.js b/services/jenkins/jenkins-tests.service.js
index 159babd45df03cf1f1f939f7a2ce2f2d96219746..061eb12f400b5a12328ef646d50c91181563913f 100644
--- a/services/jenkins/jenkins-tests.service.js
+++ b/services/jenkins/jenkins-tests.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const serverSecrets = require('../../lib/server-secrets')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class JenkinsTests extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/jitpack/jitpack.service.js b/services/jitpack/jitpack.service.js
index 23926dda36e188f0ec1418e2f55368082927274d..0a62b3ec6d321d5eb75f6cd5e50f3ec00004070f 100644
--- a/services/jitpack/jitpack.service.js
+++ b/services/jitpack/jitpack.service.js
@@ -5,6 +5,12 @@ const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Jitpack extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/lgtm/lgtm-alerts.service.js b/services/lgtm/lgtm-alerts.service.js
index aeb6c62caeedf9e2a2cb92178b9b6b056e11126e..6bbd35d12c6ab4037ee918d0aba734e575fd24b1 100644
--- a/services/lgtm/lgtm-alerts.service.js
+++ b/services/lgtm/lgtm-alerts.service.js
@@ -5,6 +5,12 @@ const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { checkErrorResponse } = require('../../lib/error-helper')
 const { metric } = require('../../lib/text-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class LgtmAlerts extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/lgtm/lgtm-grade.service.js b/services/lgtm/lgtm-grade.service.js
index 27815fb1ff8f8b1eba178e7cab78dcc84c200eac..8c6e4010fb2ebc92c5e2b24d53b728ca91c3f7dd 100644
--- a/services/lgtm/lgtm-grade.service.js
+++ b/services/lgtm/lgtm-grade.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { checkErrorResponse } = require('../../lib/error-helper')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class LgtmGrade extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/liberapay/liberapay.service.js b/services/liberapay/liberapay.service.js
index a278bf567371fbd52b7468380942b7ee7fe040aa..fb38ee6fa639bd25c488389844a66883c9563317 100644
--- a/services/liberapay/liberapay.service.js
+++ b/services/liberapay/liberapay.service.js
@@ -6,6 +6,12 @@ const { metric } = require('../../lib/text-formatters')
 const { makeLogo: getLogo } = require('../../lib/badge-data')
 const { colorScale } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Liberapay extends LegacyService {
   static get category() {
     return 'funding'
diff --git a/services/librariesio/librariesio-dependencies.service.js b/services/librariesio/librariesio-dependencies.service.js
index e68a970d881555a8e0cf5364815b6afc5487ff8d..def778e5c338f3271c5edb62f492c7d6a56db26c 100644
--- a/services/librariesio/librariesio-dependencies.service.js
+++ b/services/librariesio/librariesio-dependencies.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { checkErrorResponse } = require('../../lib/error-helper')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class LibrariesioDependencies extends LegacyService {
   static get category() {
     return 'dependencies'
diff --git a/services/luarocks/luarocks.service.js b/services/luarocks/luarocks.service.js
index ec87cf0c7c85b22b46c892d9d9816beedb97f76a..63e74d1d10eee9f3f9dfd4c1025b682f9814d264 100644
--- a/services/luarocks/luarocks.service.js
+++ b/services/luarocks/luarocks.service.js
@@ -8,6 +8,12 @@ const {
   compareVersionLists: luarocksCompareVersionLists,
 } = require('./luarocks-version')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Luarocks extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/maintenance/maintenance.service.js b/services/maintenance/maintenance.service.js
index c5dafb5fce4c120e3514e0093bd90763d9d5aeba..60147dc2d9e3cc65c78124465f78d471e40f27c2 100644
--- a/services/maintenance/maintenance.service.js
+++ b/services/maintenance/maintenance.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const log = require('../../lib/log')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Maintenance extends LegacyService {
   static get category() {
     return 'other'
diff --git a/services/maven-central/maven-central.service.js b/services/maven-central/maven-central.service.js
index 5c76ab21becf590d6c4ddcbb5d3f44769cbb2887..2539a334075f5dbfb95b95f844bccd3e9135c918 100644
--- a/services/maven-central/maven-central.service.js
+++ b/services/maven-central/maven-central.service.js
@@ -6,7 +6,12 @@ const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
-// Based on repo1.maven.org rather than search.maven.org because of #846.
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class MavenCentral extends LegacyService {
   static get category() {
     return 'version'
@@ -39,6 +44,7 @@ module.exports = class MavenCentral extends LegacyService {
         const artifactId = match[2] // eg, `guice`
         const versionPrefix = match[3] || '' // eg, `1.`
         const format = match[4] || 'gif' // eg, `svg`
+        // Based on repo1.maven.org rather than search.maven.org because of #846.
         const metadataUrl = `${'http://repo1.maven.org/maven2' +
           '/'}${encodeURIComponent(groupId).replace(
           /\./g,
diff --git a/services/maven-metadata/maven-metadata.service.js b/services/maven-metadata/maven-metadata.service.js
index af27fae1a5f424b783baf85890518604674ad438..eb22f2acf7f6101984f5f309341e184afc1b4d47 100644
--- a/services/maven-metadata/maven-metadata.service.js
+++ b/services/maven-metadata/maven-metadata.service.js
@@ -6,6 +6,12 @@ const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class MavenMetadata extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/microbadger/microbadger.service.js b/services/microbadger/microbadger.service.js
index 19e90f90b9bc858957b68b173ca7a8291230f311..db6dfbe598ab7c8830ece96fa3a83b0ed559419a 100644
--- a/services/microbadger/microbadger.service.js
+++ b/services/microbadger/microbadger.service.js
@@ -7,6 +7,12 @@ const {
   makeLabel: getLabel,
 } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class MicroBadger extends LegacyService {
   static get category() {
     return 'size'
diff --git a/services/nexus/nexus.service.js b/services/nexus/nexus.service.js
index eedb928941ca2d19bc4af86e1326c45c13d3f1d6..1d2dcd76250d54b16c2d981028fd473efcd5dded 100644
--- a/services/nexus/nexus.service.js
+++ b/services/nexus/nexus.service.js
@@ -6,6 +6,12 @@ const { isSnapshotVersion: isNexusSnapshotVersion } = require('./nexus-version')
 const { addv: versionText } = require('../../lib/text-formatters')
 const { version: versionColor } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Nexus extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/osstracker/osstracker.service.js b/services/osstracker/osstracker.service.js
index f8eb61fe99c94bb243e02be4034d5695b87120fc..53aede7bbae832a6710e638d1ee5e807d2151f52 100644
--- a/services/osstracker/osstracker.service.js
+++ b/services/osstracker/osstracker.service.js
@@ -5,6 +5,13 @@ const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const log = require('../../lib/log')
 
 // For NetflixOSS metadata: https://github.com/Netflix/osstracker
+//
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class OssTracker extends LegacyService {
   static get category() {
     return 'other'
diff --git a/services/packagecontrol/packagecontrol.service.js b/services/packagecontrol/packagecontrol.service.js
index 213a5304d37e024d4c0ef1c789dfb951b6217ce9..4393e48f6f403a431e60f28d80bf7ed00b052176 100644
--- a/services/packagecontrol/packagecontrol.service.js
+++ b/services/packagecontrol/packagecontrol.service.js
@@ -7,6 +7,12 @@ const {
   downloadCount: downloadCountColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class PackageControl extends LegacyService {
   static get category() {
     return 'downloads'
diff --git a/services/packagist/packagist-downloads.service.js b/services/packagist/packagist-downloads.service.js
index a69c02cc0d97f39d8c066e67e5dfb3da80080cb7..0bb7a62dce8e152ec1f6afade20245751e30569a 100644
--- a/services/packagist/packagist-downloads.service.js
+++ b/services/packagist/packagist-downloads.service.js
@@ -7,6 +7,12 @@ const {
   downloadCount: downloadCountColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class PackagistDownloads extends LegacyService {
   static get category() {
     return 'downloads'
diff --git a/services/packagist/packagist-license.service.js b/services/packagist/packagist-license.service.js
index 1ef12fa9dd9f9c97aefe8057ab90f48e0b6cdeeb..3527c60c102843df8aefc9684b8b51f1a8fb4d72 100644
--- a/services/packagist/packagist-license.service.js
+++ b/services/packagist/packagist-license.service.js
@@ -3,6 +3,12 @@
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class PackagistLicense extends LegacyService {
   static get category() {
     return 'license'
diff --git a/services/packagist/packagist-php-version.service.js b/services/packagist/packagist-php-version.service.js
index 33e91bb888ed843a488c70812a11c292f500bafd..a70b76d4ebde4980c4e7a94685e2b4f2cf57f532 100644
--- a/services/packagist/packagist-php-version.service.js
+++ b/services/packagist/packagist-php-version.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const log = require('../../lib/log')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class PackagistPhpVersion extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/packagist/packagist-version.service.js b/services/packagist/packagist-version.service.js
index e4b6de281136fbd7abd59eb61bdb66d956198cb6..1ce130a0c948175432bf2c0b80c5a36fab5f2665 100644
--- a/services/packagist/packagist-version.service.js
+++ b/services/packagist/packagist-version.service.js
@@ -10,6 +10,12 @@ const {
   isStable: phpStableVersion,
 } = require('../../lib/php-version')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class PackagistVersion extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/php-eye/php-eye-hhvm.service.js b/services/php-eye/php-eye-hhvm.service.js
index 0baa791d609fd60c00b918d3c4272c1525eb1f2e..042028083d1a1f4b7a586842496984c958a42d50 100644
--- a/services/php-eye/php-eye-hhvm.service.js
+++ b/services/php-eye/php-eye-hhvm.service.js
@@ -7,6 +7,12 @@ const { omitv } = require('../../lib/text-formatters')
 
 const keywords = ['php', 'runtime']
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class PhpeyeHhvm extends LegacyService {
   static get category() {
     return 'platform-support'
diff --git a/services/php-eye/php-eye-php-version.service.js b/services/php-eye/php-eye-php-version.service.js
index 11d50b531920143b46d7da92dbf843f2d1584c84..a00672a2989bd169b8734a874c2e845135a9dbeb 100644
--- a/services/php-eye/php-eye-php-version.service.js
+++ b/services/php-eye/php-eye-php-version.service.js
@@ -8,6 +8,12 @@ const {
 } = require('../../lib/php-version')
 const log = require('../../lib/log')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class PhpEyePhpVersion extends LegacyService {
   static get category() {
     return 'platform-support'
diff --git a/services/pub/pub.service.js b/services/pub/pub.service.js
index 2c42b5154f4f158bfc02de5ad9c59aabc3a6bb79..813bca4c25f4efc2356b36e87bc988d334fb5c2e 100644
--- a/services/pub/pub.service.js
+++ b/services/pub/pub.service.js
@@ -7,6 +7,13 @@ const { version: versionColor } = require('../../lib/color-formatters')
 const { latest: latestVersion } = require('../../lib/version')
 
 // For Dart's pub.
+//
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Pub extends LegacyService {
   static get category() {
     return 'version'
diff --git a/services/puppetforge/puppetforge-modules.service.js b/services/puppetforge/puppetforge-modules.service.js
index f9d7967a11b1f36eaac4bf5a28988246b5a3febf..9c958b3a7834ad98660c2e2a6ef5d824798e3f7b 100644
--- a/services/puppetforge/puppetforge-modules.service.js
+++ b/services/puppetforge/puppetforge-modules.service.js
@@ -104,6 +104,12 @@ class PuppetforgeModuleFeedback extends LegacyService {
   static registerLegacyRouteHandler() {}
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class PuppetforgeModules extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/puppetforge/puppetforge-users.service.js b/services/puppetforge/puppetforge-users.service.js
index 32304985e2fc6bf66edab5491c0695bb7b8d9c61..d23c198cef4abe6902cb9df26d47676b7d528e45 100644
--- a/services/puppetforge/puppetforge-users.service.js
+++ b/services/puppetforge/puppetforge-users.service.js
@@ -54,6 +54,12 @@ class PuppetforgeUserModules extends LegacyService {
   static registerLegacyRouteHandler() {}
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class PuppetforgeUsers extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/scrutinizer/scrutinizer.service.js b/services/scrutinizer/scrutinizer.service.js
index f579b8bff704d55b3cfacd5a8f6687704a6273af..a51cb48091f8f9d2f31323206b6484beab853c3d 100644
--- a/services/scrutinizer/scrutinizer.service.js
+++ b/services/scrutinizer/scrutinizer.service.js
@@ -30,6 +30,12 @@ class ScrutinizerBuild extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {}
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class Scrutinizer extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/sensiolabs/sensiolabs.service.js b/services/sensiolabs/sensiolabs.service.js
index d6f40b3eb980585b657bf54825c880614667a6df..5b3bab5cce473334220dae7ffc82978cda074192 100644
--- a/services/sensiolabs/sensiolabs.service.js
+++ b/services/sensiolabs/sensiolabs.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const serverSecrets = require('../../lib/server-secrets')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Sensiolabs extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/shippable/shippable.service.js b/services/shippable/shippable.service.js
index 6fad533cb298df77d76907d955c3ec34baa1049d..6b9d80bb6f24f839130aefca80cb24ee70345c18 100644
--- a/services/shippable/shippable.service.js
+++ b/services/shippable/shippable.service.js
@@ -4,6 +4,12 @@ const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 const { checkErrorResponse } = require('../../lib/error-helper')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Shippable extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/sonarqube/sonarqube.service.js b/services/sonarqube/sonarqube.service.js
index 37212ea61acdd868caaf8e4cad9c035ee4d7cd8d..a863b5081223853ab1effeb639af6814d6e0c566 100644
--- a/services/sonarqube/sonarqube.service.js
+++ b/services/sonarqube/sonarqube.service.js
@@ -8,6 +8,12 @@ const {
   coveragePercentage: coveragePercentageColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Sonarqube extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/sourceforge/sourceforge.service.js b/services/sourceforge/sourceforge.service.js
index fa9ad2e77c4967f1316c4ef96b6ac06502e263f9..d06e851feeae235714da1791b206072216bf4943 100644
--- a/services/sourceforge/sourceforge.service.js
+++ b/services/sourceforge/sourceforge.service.js
@@ -11,6 +11,12 @@ const {
   downloadCount: downloadCountColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Sourceforge extends LegacyService {
   static get category() {
     return 'downloads'
diff --git a/services/teamcity/teamcity-build.service.js b/services/teamcity/teamcity-build.service.js
index 947ae20e8daa32e4f6d31dab675d9735f24e007a..1b252776a6938bb5f0c4a5a15653524d00922a7a 100644
--- a/services/teamcity/teamcity-build.service.js
+++ b/services/teamcity/teamcity-build.service.js
@@ -3,6 +3,12 @@
 const LegacyService = require('../legacy-service')
 const { makeBadgeData: getBadgeData } = require('../../lib/badge-data')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 function teamcityBadge(
   url,
   buildId,
diff --git a/services/teamcity/teamcity-coverage.service.js b/services/teamcity/teamcity-coverage.service.js
index 72ffe8155649741fd9a2de420337f70c19a1bd96..19b78d082e3597b71c22e1d400a30a94cf902cf4 100644
--- a/services/teamcity/teamcity-coverage.service.js
+++ b/services/teamcity/teamcity-coverage.service.js
@@ -6,6 +6,12 @@ const {
   coveragePercentage: coveragePercentageColor,
 } = require('../../lib/color-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class TeamcityCoverage extends LegacyService {
   static get category() {
     return 'quality'
diff --git a/services/travis/travis-build.service.js b/services/travis/travis-build.service.js
index 78dec2ff9dc802d557afe4ef188c6aaec59c0c1d..f4f872efe5113b9e38a597a7afd8acf866a59631 100644
--- a/services/travis/travis-build.service.js
+++ b/services/travis/travis-build.service.js
@@ -6,6 +6,13 @@ const { checkErrorResponse } = require('../../lib/error-helper')
 const log = require('../../lib/log')
 
 // Handle .org and .com.
+//
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class TravisBuild extends LegacyService {
   static get category() {
     return 'build'
diff --git a/services/travis/travis-php-version.service.js b/services/travis/travis-php-version.service.js
index 4c23fa47fd0b3c38d58c2c0944ca49d51c41ab91..6ca312d93cf70e4dd2588a09b2970b0c97b96fee 100644
--- a/services/travis/travis-php-version.service.js
+++ b/services/travis/travis-php-version.service.js
@@ -9,6 +9,12 @@ const {
   getPhpReleases,
 } = require('../../lib/php-version')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class TravisPhpVersion extends LegacyService {
   static get category() {
     return 'platform-support'
diff --git a/services/twitter/twitter.service.js b/services/twitter/twitter.service.js
index 76244884ee58a279f6b13740dddeaf525bffe566..70fba968115d57226261c48942f51cca723c8ab6 100644
--- a/services/twitter/twitter.service.js
+++ b/services/twitter/twitter.service.js
@@ -7,6 +7,12 @@ const {
 } = require('../../lib/badge-data')
 const { metric } = require('../../lib/text-formatters')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class TwitterUrl extends LegacyService {
   static get category() {
     return 'social'
@@ -55,6 +61,12 @@ class TwitterUrl extends LegacyService {
   }
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class TwitterFollow extends LegacyService {
   static get category() {
     return 'social'
diff --git a/services/vaadin-directory/vaadin-directory.service.js b/services/vaadin-directory/vaadin-directory.service.js
index 3c47841cba6263cb96bf8f80a9c411bc1c91bd47..b7bbb003dede0451e95abaff799205f9ac676b4d 100644
--- a/services/vaadin-directory/vaadin-directory.service.js
+++ b/services/vaadin-directory/vaadin-directory.service.js
@@ -169,6 +169,12 @@ class VaadinDirectoryReleaseDate extends LegacyService {
   static registerLegacyRouteHandler() {}
 }
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 class VaadinDirectory extends LegacyService {
   static registerLegacyRouteHandler({ camp, cache }) {
     camp.route(
diff --git a/services/vscode-marketplace/vscode-marketplace.service.js b/services/vscode-marketplace/vscode-marketplace.service.js
index 519ca67b2651d77ba6e178f9f0afdae0a0674394..07a8d6400bc208257836afcb0fd6447fafc3dfd0 100644
--- a/services/vscode-marketplace/vscode-marketplace.service.js
+++ b/services/vscode-marketplace/vscode-marketplace.service.js
@@ -1,5 +1,12 @@
 'use strict'
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
+
 const LegacyService = require('../legacy-service')
 const {
   makeBadgeData: getBadgeData,
diff --git a/services/waffle/waffle.service.js b/services/waffle/waffle.service.js
index 2cfec099af087f9bbeef48f650cb753c5a7a19d3..4cf2e2270c8b01266da38915fcd50027f7e26025 100644
--- a/services/waffle/waffle.service.js
+++ b/services/waffle/waffle.service.js
@@ -8,6 +8,12 @@ const {
 } = require('../../lib/badge-data')
 const { checkErrorResponse } = require('../../lib/error-helper')
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Waffle extends LegacyService {
   static get category() {
     return 'issue-tracking'
diff --git a/services/website/website.service.js b/services/website/website.service.js
index 20172f3682a2393d95c90482b2dd3077e1015b8c..142be209cc8a957932b18bc0bfb0d6e0f94edf66 100644
--- a/services/website/website.service.js
+++ b/services/website/website.service.js
@@ -69,6 +69,12 @@ const documentation = `
 </p>
 `
 
+// This legacy service should be rewritten to use e.g. BaseJsonService.
+//
+// Tips for rewriting:
+// https://github.com/badges/shields/blob/master/doc/rewriting-services.md
+//
+// Do not base new services on this code.
 module.exports = class Website extends LegacyService {
   static get category() {
     return 'monitoring'