chore: update links in github issue templates and switch to using compodoc

.github/.OwlBot.lock.yaml

@@ -13,5 +13,5 @@
 # limitations under the License.
 docker:
   image: gcr.io/cloud-devrel-public-resources/owlbot-nodejs:latest
-  digest: sha256:a5af6af827a9fffba373151e1453b0498da288024cdd16477900dd42857a42e0
-# created: 2024-09-20T20:26:11.126243246Z
+  digest: sha256:609822e3c09b7a1bd90b99655904609f162cc15acb4704f1edf778284c36f429
+# created: 2024-10-01T19:34:30.797530443Z

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -24,12 +24,12 @@ body:
             e.js"
           required: true
         - label: "Check our Troubleshooting guide:
-            https://googlecloudplatform.github.io/google-cloud-node/#/docs/guid\
-            es/troubleshooting"
+            https://github.com/googleapis/google-cloud-node/blob/main/docs/trou\
+            bleshooting.md"
           required: true
         - label: "Check our FAQ:
-            https://googlecloudplatform.github.io/google-cloud-node/#/docs/guid\
-            es/faq"
+            https://github.com/googleapis/google-cloud-node/blob/main/docs/faq.\
+            md"
           required: true
         - label: "Check our libraries HOW-TO:
             https://github.com/googleapis/gax-nodejs/blob/main/client-libraries\
@@ -55,9 +55,9 @@ body:
         behavior you are experiencing. If the behavior is the same, it means
         that you are likely experiencing a bug with the API itself. In that
         case, please submit an issue to the API team, either by submitting an
-        issue in its issue tracker https://cloud.google.com/support/docs/issue-trackers, or by
+        issue in its issue tracker (https://cloud.google.com/support/docs/issue-trackers), or by
         submitting an issue in its linked tracker in the .repo-metadata.json
-        file        
+        file     
     validations:
       required: true
   - type: input

.github/ISSUE_TEMPLATE/processs_request.md

@@ -1,5 +1,4 @@
 ---
 name: Process Request
-about: Submit a process request to the library. Process requests are any requests related to library infrastructure, including CI/CD, publishing, releasing, etc. This issue template should primarily used by internal members.
-
----
+about: Submit a process request to the library. Process requests are any requests related to library infrastructure, for example CI/CD, publishing, releasing, broken links.
+---

.github/scripts/close-invalid-link.cjs

@@ -40,9 +40,12 @@ module.exports = async ({github, context}) => {
     const isBugTemplate = issue.data.body.includes('Link to the code that reproduces this issue');
 
     if (isBugTemplate) {
+        console.log(`Issue ${number} is a bug template`)
         try {
-            const link = issue.data.body.split('\n')[18].match(/(https?:\/\/g?i?s?t?\.?github.com\/.*)/);
+            const link = issue.data.body.split('\n')[18].match(/(https?:\/\/(gist\.)?github.com\/.*)/)[0];
+            console.log(`Issue ${number} contains this link: ${link}`)
             const isValidLink = (await fetch(link)).ok;
+            console.log(`Issue ${number} has a ${isValidLink ? 'valid' : 'invalid'} link`)
             if (!isValidLink) {
             await closeIssue(github, owner, repo, number);
             }

.jsdoc.js

@@ -31,7 +31,7 @@ module.exports = {
   source: {
     excludePattern: '(^|\\/|\\\\)[._]',
     include: [
-      'src',
+      'build/src',
     ],
     includePattern: '\\.js$'
   },

owlbot.py

@@ -22,5 +22,6 @@
 node.owlbot_main(
     templates_excludes=[
         ".github/workflows/ci.yaml",
+        ".github/ISSUE_TEMPLATE/bug_report.yml"
     ],
 )

package.json

@@ -25,7 +25,6 @@
     "jws": "^4.0.0"
   },
   "devDependencies": {
-    "@compodoc/compodoc": "1.1.23",
     "@types/base64-js": "^1.2.5",
     "@types/chai": "^4.1.7",
     "@types/jws": "^3.1.0",
@@ -42,6 +41,9 @@
     "execa": "^5.0.0",
     "gts": "^5.0.0",
     "is-docker": "^2.0.0",
+    "jsdoc": "^4.0.0",
+    "jsdoc-fresh": "^3.0.0",
+    "jsdoc-region-tag": "^3.0.0",
     "karma": "^6.0.0",
     "karma-chrome-launcher": "^3.0.0",
     "karma-coverage": "^2.0.0",
@@ -76,7 +78,7 @@
     "compile": "tsc -p .",
     "fix": "gts fix",
     "pretest": "npm run compile -- --sourceMap",
-    "docs": "compodoc src/",
+    "docs": "jsdoc -c .jsdoc.json",
     "samples-setup": "cd samples/ && npm link ../ && npm run setup && cd ../",
     "samples-test": "cd samples/ && npm link ../ && npm test && cd ../",
     "system-test": "mocha build/system-test --timeout 60000",