chore: update links from developers.google.com to docs.blockly.com

.github/ISSUE_TEMPLATE/documentation.yaml

@@ -8,7 +8,7 @@ body:
       value: >
         Thanks for helping us improve our developer site documentation!
         Use this template to describe issues with the content on our
-        [developer site](https://developers.google.com/blockly/guides).
+        [developer site](https://docs.blockly.com/).
   - type: input
     id: link
     attributes:

.github/PULL_REQUEST_TEMPLATE.md

@@ -7,7 +7,7 @@
 
 <!-- TODO: Verify the following, checking each box with an 'x' between the brackets: [x] -->
 
-- [ ] I [validated my changes](https://developers.google.com/blockly/guides/contribute/core#making_and_verifying_a_change)
+- [ ] I [validated my changes](https://docs.blockly.com/guides/contribute/core/#make-and-verify-a-change)
 
 ## The details
 ### Resolves

.github/workflows/welcome_new_contributors.yml

@@ -23,15 +23,15 @@ jobs:
 
             - You can find tips about contributing to Blockly and how to
             validate your changes on our
-            [developer site](https://developers.google.com/blockly/guides/contribute/core#making_and_verifying_a_change).
+            [developer site](https://docs.blockly.com/guides/contribute/core/#make-and-verify-a-change).
 
             - We use conventional commits to make versioning the package easier. Make sure your commit
-            message is in the [proper format](https://developers.google.com/blockly/guides/contribute/get-started/commits)
-            or [learn how to fix it](https://developers.google.com/blockly/guides/contribute/get-started/commits#fixing_non-conventional_commits).
+            message is in the [proper format](https://docs.blockly.com/guides/contribute/get-started/commits/)
+            or [learn how to fix it](https://docs.blockly.com/guides/contribute/get-started/commits/#fixing-non-conventional-commits).
 
             - If any of the other checks on this PR fail, you can click on
             them to learn why. It might be that your change caused a test
             failure, or that you need to double-check the
-            [style guide](https://developers.google.com/blockly/guides/contribute/core/style_guide).
+            [style guide](https://docs.blockly.com/guides/contribute/core/style_guide/).
 
             Thank you for opening this PR! A member of the Blockly team will review it soon.

commitlint.config.mjs

@@ -34,6 +34,5 @@ export default {
     ],
     'subject-case': [0],
   },
-  helpUrl:
-    'https://developers.google.com/blockly/guides/contribute/get-started/commits',
+  helpUrl: 'https://docs.blockly.com/guides/contribute/get-started/commits/',
 };

packages/blockly/core/field.ts

@@ -48,7 +48,7 @@ import {WorkspaceSvg} from './workspace_svg.js';
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.
@@ -888,7 +888,7 @@ export abstract class Field<T = any>
    * at relevant times, such as when the parent block or renderer changes.
    *
    * See {@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/customizing-fields/creating#matching_block_colours
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/customizing-fields/creating/#matching-block-colours
    * | the field documentation} for more information, or FieldDropdown for an
    * example.
    */
@@ -1307,7 +1307,7 @@ export abstract class Field<T = any>
    * it is valid for a subclass to return `undefined` if the new value is
    * compatible with `T`.
    *
-   * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+   * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
    * @param newValue - The value to be validated.
    * @returns One of three instructions for setting the new value: `T`, `null`,
    * or `undefined`.

packages/blockly/core/field_checkbox.ts

@@ -50,7 +50,7 @@ export class FieldCheckbox extends Field<CheckboxBool> {
    *     validated value ('TRUE' or 'FALSE'), or null to abort the change.
    * @param config A map of options used to configure the field.
    *     See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/checkbox#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/checkbox/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(
@@ -308,7 +308,7 @@ export interface FieldCheckboxFromJsonConfig extends FieldCheckboxConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

packages/blockly/core/field_dropdown.ts

@@ -117,7 +117,7 @@ export class FieldDropdown extends Field<string> {
    *     change.
    * @param config A map of options used to configure the field.
    *     See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/dropdown#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/dropdown/#creation}
    * for a list of properties this parameter supports.
    * @throws {TypeError} If `menuGenerator` options are incorrectly structured.
    */
@@ -1060,7 +1060,7 @@ export interface FieldDropdownFromJsonConfig extends FieldDropdownConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

packages/blockly/core/field_image.ts

@@ -69,7 +69,7 @@ export class FieldImage extends Field<string> {
    * @param flipRtl Whether to flip the icon in RTL.
    * @param config A map of options used to configure the field.
    *     See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/image#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/image/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(

packages/blockly/core/field_input.ts

@@ -142,7 +142,7 @@ export abstract class FieldInput<T extends InputTypes> extends Field<
    *     to abort the change.
    * @param config A map of options used to configure the field.
    *     See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/text-input/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(
@@ -1009,7 +1009,7 @@ export interface FieldInputConfig extends FieldConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

packages/blockly/core/field_label.ts

@@ -47,7 +47,7 @@ export class FieldLabel extends Field<string> {
    * @param textClass Optional CSS class for the field's text.
    * @param config A map of options used to configure the field.
    *    See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/label#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/label/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(

packages/blockly/core/field_label_serializable.ts

@@ -44,7 +44,7 @@ export class FieldLabelSerializable extends FieldLabel {
    * @param textClass Optional CSS class for the field's text.
    * @param config A map of options used to configure the field.
    *    See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/label-serializable#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/label-serializable/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(value?: string, textClass?: string, config?: FieldLabelConfig) {

packages/blockly/core/field_number.ts

@@ -59,7 +59,7 @@ export class FieldNumber extends FieldInput<number> {
    *     to abort the change.
    * @param config A map of options used to configure the field.
    *     See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/number#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/number/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(
@@ -378,7 +378,7 @@ export interface FieldNumberFromJsonConfig extends FieldNumberConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

packages/blockly/core/field_textinput.ts

@@ -37,7 +37,7 @@ export class FieldTextInput extends FieldInput<string> {
    *     to abort the change.
    * @param config A map of options used to configure the field.
    *     See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/text-input/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(
@@ -122,7 +122,7 @@ export interface FieldTextInputFromJsonConfig extends FieldTextInputConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

packages/blockly/core/field_variable.ts

@@ -73,7 +73,7 @@ export class FieldVariable extends FieldDropdown {
    *     is not provided.
    * @param config A map of options used to configure the field.
    *    See the [field creation documentation]{@link
-   * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/variable#creation}
+   * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/variable/#creation}
    * for a list of properties this parameter supports.
    */
   constructor(
@@ -649,7 +649,7 @@ export interface FieldVariableFromJsonConfig extends FieldVariableConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

packages/blockly/core/generator.ts

@@ -22,7 +22,7 @@ import type {Workspace} from './workspace.js';
  * functions.
  *
  * @deprecated
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/generating-code}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/code-generation/overview/#block-code-generators}
  * @param block The Block instance to generate code for.
  * @param generator The CodeGenerator calling the function.
  * @returns A string containing the generated code (for statement blocks),
@@ -318,7 +318,7 @@ export class CodeGenerator {
     if (!Array.isArray(tuple)) {
       throw TypeError(
         `Expecting tuple from value block: ${targetBlock.type} See ` +
-          `developers.google.com/blockly/guides/create-custom-blocks/generating-code ` +
+          `docs.blockly.com/guides/create-custom-blocks/code-generation/overview/ ` +
           `for more information`,
       );
     }

packages/blockly/core/grid.ts

@@ -32,7 +32,7 @@ export class Grid {
    * @param pattern The grid's SVG pattern, created during injection.
    * @param options A dictionary of normalized options for the grid.
    *     See grid documentation:
-   *     https://developers.google.com/blockly/guides/configure/grid
+   *     https://docs.blockly.com/guides/configure/grid/
    */
   constructor(
     private pattern: SVGElement,

packages/blockly/core/options.ts

@@ -78,7 +78,7 @@ export class Options {
   /**
    * @param options Dictionary of options.
    *     Specification:
-   * https://developers.google.com/blockly/guides/get-started/web#configuration
+   * https://docs.blockly.com/guides/configure/configuration_struct/#the-options-dictionary
    */
   constructor(options: BlocklyOptions) {
     let toolboxJsonDef = null;
@@ -255,7 +255,7 @@ export class Options {
   /**
    * Parse the user-specified zoom options, using reasonable defaults where
    * behaviour is unspecified.  See zoom documentation:
-   *   https://developers.google.com/blockly/guides/configure/zoom
+   *   https://docs.blockly.com/guides/configure/zoom/
    *
    * @param options Dictionary of options.
    * @returns Normalized zoom options.
@@ -304,7 +304,7 @@ export class Options {
   /**
    * Parse the user-specified grid options, using reasonable defaults where
    * behaviour is unspecified. See grid documentation:
-   *   https://developers.google.com/blockly/guides/configure/grid
+   *   https://docs.blockly.com/guides/configure/grid/
    *
    * @param options Dictionary of options.
    * @returns Normalized grid options.
@@ -322,7 +322,7 @@ export class Options {
 
   /**
    * Parse the user-specified theme options, using the classic theme as a
-   * default. https://developers.google.com/blockly/guides/configure/appearance/themes
+   * default. https://docs.blockly.com/guides/configure/appearance/themes/
    *
    * @param options Dictionary of options.
    * @returns A Blockly Theme.

packages/blockly/demos/blockfactory/app_controller.js

@@ -507,7 +507,7 @@ AppController.prototype.assignBlockFactoryClickHandlers = function() {
 
   document.getElementById('helpButton').addEventListener('click',
       function() {
-        open('https://developers.google.com/blockly/guides/create-custom-blocks/legacy-blockly-developer-tools',
+        open('https://docs.blockly.com/guides/create-custom-blocks/legacy-blockly-developer-tools/',
              'BlockFactoryHelp');
       });
 

packages/blockly/demos/blockfactory/blocks.js

@@ -50,7 +50,7 @@ Blockly.Blocks['factory_base'] = {
     this.setTooltip('Build a custom block by plugging\n' +
         'fields, inputs and other blocks here.');
     this.setHelpUrl(
-        'https://developers.google.com/blockly/guides/create-custom-blocks/block-factory');
+        'https://docs.blockly.com/guides/create-custom-blocks/legacy-blockly-developer-tools/');
   },
   mutationToDom: function() {
     var container = Blockly.utils.xml.createElement('mutation');
@@ -242,7 +242,7 @@ Blockly.Blocks['input_end_row'] = {
                  "be rendered on a separate row from any following inputs. " +
                  "Alignment options (left, right, centre) only affect " +
                  "multi-row blocks.",
-      "helpUrl": "https://developers.google.com/blockly/guides/create-custom-blocks/define-blocks#block_inputs"
+      "helpUrl": "https://docs.blockly.com/guides/create-custom-blocks/define/block-anatomy/#inputs"
     });
   }
 };

packages/blockly/demos/blockfactory/index.html

@@ -45,7 +45,7 @@
   </script>
 </head>
 <body>
-  <h1><a href="https://developers.google.com/blockly/">Blockly</a> &gt;
+  <h1><a href="https://docs.blockly.com/">Blockly</a> &gt;
     <a href="../index.html">Demos</a> &gt; Blockly Developer Tools
     <button id="helpButton" title="View documentation in new window.">
       <span>Help</span>
@@ -54,7 +54,7 @@ <h1><a href="https://developers.google.com/blockly/">Blockly</a> &gt;
     </button>
   </h1>
   <div id="legacyBanner">
-    This version of Developer Tools is only compatible with Blockly version 10 and earlier. Try the <a target="_blank" href="https://google.github.io/blockly-samples/examples/developer-tools/index.html">new Block Factory</a> and <a target="_blank" href="https://developers.google.com/blockly/guides/create-custom-blocks/blockly-developer-tools#import_from_legacy_block_factory">learn how to migrate your blocks</a>.
+    This version of Developer Tools is only compatible with Blockly version 10 and earlier. Try the <a target="_blank" href="https://google.github.io/blockly-samples/examples/developer-tools/index.html">new Block Factory</a> and <a target="_blank" href="https://docs.blockly.com/guides/create-custom-blocks/blockly-developer-tools/#import-from-legacy-block-factory">learn how to migrate your blocks</a>.
   </div>
   <div id="tabContainer">
     <div id="blockFactory_tab" class="tab tabon">Block Factory</div>

packages/blockly/demos/blockfactory/workspacefactory/wfactory_init.js

@@ -280,7 +280,7 @@ WorkspaceFactoryInit.assignWorkspaceFactoryClickHandlers_ =
   // Help button on workspace tab.
   document.getElementById('button_optionsHelp').addEventListener
       ('click', function() {
-        open('https://developers.google.com/blockly/guides/get-started/web#configuration');
+        open('https://docs.blockly.com/guides/configure/configuration_struct/#the-options-dictionary');
       });
 
   // Reset to Default button on workspace tab.

packages/blockly/demos/code/index.html

@@ -20,7 +20,7 @@
   <table width="100%" height="100%">
     <tr>
       <td>
-        <h1><a href="https://developers.google.com/blockly/">Blockly</a>&rlm; &gt;
+        <h1><a href="https://docs.blockly.com/">Blockly</a>&rlm; &gt;
           <a href="../index.html">Demos</a>&rlm; &gt;
           <span id="title">...</span>
         </h1>

packages/blockly/demos/index.html

@@ -22,7 +22,7 @@
   </style>
 </head>
 <body>
-  <h1><a href="https://developers.google.com/blockly/">Blockly</a> &gt; Demos</h1>
+  <h1><a href="https://docs.blockly.com/">Blockly</a> &gt; Demos</h1>
 
   <p>Check out the <a href="https://google.github.io/blockly-samples/">Blockly samples page</a> for a comprehensive list of demos for developers who want to integrate Blockly into their own applications.</p>
   <p>The demos on this page combine Blockly features and AppEngine storage.</p>

packages/blockly/demos/storage/index.html

@@ -29,7 +29,7 @@
   </style>
 </head>
 <body>
-  <h1><a href="https://developers.google.com/blockly/">Blockly</a> &gt;
+  <h1><a href="https://docs.blockly.com/">Blockly</a> &gt;
     <a href="../index.html">Demos</a> &gt; Cloud Storage</h1>
 
   <p>This is a simple demo of cloud storage using App Engine.</p>