feat(docs): add google/auth to refdocs (#8047)

* feat(docs): add google/auth to refdocs

* remove \Google\Auth linking to external docs

* update refdocs in fixtures

* Update phpunit.xml.dist

* see if upgrading phpdoc fixes it

* upgrade to 3.5.3

.github/workflows/docs.yaml

@@ -26,7 +26,7 @@ jobs:
       id: extract
       uses: shrink/actions-docker-extract@v2
       with:
-        image: "phpdoc/phpdoc:3.4.1"
+        image: "phpdoc/phpdoc:3.5.3"
         path: "/opt/phpdoc/."
     - name: Symlink phpDocumentor
       run: ln -s $(pwd)/${{ steps.extract.outputs.destination }}/bin/phpdoc /usr/local/bin/phpdoc

.kokoro/docs/publish.sh

@@ -51,6 +51,15 @@ $PROJECT_DIR/dev/google-cloud docfx \
     $STAGING_FLAG \
     $VERBOSITY_FLAG
 
+# Add Auth repo
+AUTH_DIR=$PROJECT_DIR/dev/vendor/google/auth
+$PROJECT_DIR/dev/google-cloud docfx \
+    --path $AUTH_DIR \
+    --out auth-out \
+    --metadata-version $(cat $AUTH_DIR/VERSION) \
+    $STAGING_FLAG \
+    $VERBOSITY_FLAG
+
 # If this run after a release, store the released artifacts.
 if [ "$KOKORO_GITHUB_COMMIT" != "" ]; then
     # Move to the project directory

dev/src/DocFx/Node/XrefTrait.php

@@ -177,9 +177,6 @@ private function replaceUidWithLink(string $uid, ?string $name = null): string
 
         // Check for external package namespaces
         switch (true) {
-            case str_starts_with($uid, '\Google\Auth\\'):
-                $extLinkRoot = 'https://googleapis.github.io/google-auth-library-php/main/';
-                break;
             case str_starts_with($uid, '\Google\Protobuf\\'):
                 $extLinkRoot = 'https://protobuf.dev/reference/php/api-docs/';
                 break;

dev/tests/fixtures/docfx/NewClient/V1.Client.SecretManagerServiceClient.yml

@@ -89,7 +89,7 @@ items:
         -
           id: '↳ credentials'
           var_type: string|array|FetchAuthTokenInterface|CredentialsWrapper
-          description: 'The credentials to be used by the client to authorize API calls. This option accepts either a path to a credentials file, or a decoded credentials file as a PHP array. *Advanced usage*: In addition, this option can also accept a pre-constructed <a href="https://googleapis.github.io/google-auth-library-php/main/Google/Auth/FetchAuthTokenInterface">Google\Auth\FetchAuthTokenInterface</a> object or <xref uid="\Google\ApiCore\CredentialsWrapper">Google\ApiCore\CredentialsWrapper</xref> object. Note that when one of these objects are provided, any settings in $credentialsConfig will be ignored.'
+          description: 'The credentials to be used by the client to authorize API calls. This option accepts either a path to a credentials file, or a decoded credentials file as a PHP array. *Advanced usage*: In addition, this option can also accept a pre-constructed <xref uid="\Google\Auth\FetchAuthTokenInterface">Google\Auth\FetchAuthTokenInterface</xref> object or <xref uid="\Google\ApiCore\CredentialsWrapper">Google\ApiCore\CredentialsWrapper</xref> object. Note that when one of these objects are provided, any settings in $credentialsConfig will be ignored.'
         -
           id: '↳ credentialsConfig'
           var_type: array

dev/tests/fixtures/docfx/Vision/V1.Client.ImageAnnotatorClient.yml

@@ -57,7 +57,7 @@ items:
         -
           id: '↳ credentials'
           var_type: string|array|FetchAuthTokenInterface|CredentialsWrapper
-          description: 'The credentials to be used by the client to authorize API calls. This option accepts either a path to a credentials file, or a decoded credentials file as a PHP array. *Advanced usage*: In addition, this option can also accept a pre-constructed <a href="https://googleapis.github.io/google-auth-library-php/main/Google/Auth/FetchAuthTokenInterface">Google\Auth\FetchAuthTokenInterface</a> object or <xref uid="\Google\ApiCore\CredentialsWrapper">Google\ApiCore\CredentialsWrapper</xref> object. Note that when one of these objects are provided, any settings in $credentialsConfig will be ignored.'
+          description: 'The credentials to be used by the client to authorize API calls. This option accepts either a path to a credentials file, or a decoded credentials file as a PHP array. *Advanced usage*: In addition, this option can also accept a pre-constructed <xref uid="\Google\Auth\FetchAuthTokenInterface">Google\Auth\FetchAuthTokenInterface</xref> object or <xref uid="\Google\ApiCore\CredentialsWrapper">Google\ApiCore\CredentialsWrapper</xref> object. Note that when one of these objects are provided, any settings in $credentialsConfig will be ignored.'
         -
           id: '↳ credentialsConfig'
           var_type: array

dev/tests/fixtures/docfx/Vision/V1.Client.ProductSearchClient.yml

@@ -103,7 +103,7 @@ items:
         -
           id: '↳ credentials'
           var_type: string|array|FetchAuthTokenInterface|CredentialsWrapper
-          description: 'The credentials to be used by the client to authorize API calls. This option accepts either a path to a credentials file, or a decoded credentials file as a PHP array. *Advanced usage*: In addition, this option can also accept a pre-constructed <a href="https://googleapis.github.io/google-auth-library-php/main/Google/Auth/FetchAuthTokenInterface">Google\Auth\FetchAuthTokenInterface</a> object or <xref uid="\Google\ApiCore\CredentialsWrapper">Google\ApiCore\CredentialsWrapper</xref> object. Note that when one of these objects are provided, any settings in $credentialsConfig will be ignored.'
+          description: 'The credentials to be used by the client to authorize API calls. This option accepts either a path to a credentials file, or a decoded credentials file as a PHP array. *Advanced usage*: In addition, this option can also accept a pre-constructed <xref uid="\Google\Auth\FetchAuthTokenInterface">Google\Auth\FetchAuthTokenInterface</xref> object or <xref uid="\Google\ApiCore\CredentialsWrapper">Google\ApiCore\CredentialsWrapper</xref> object. Note that when one of these objects are provided, any settings in $credentialsConfig will be ignored.'
         -
           id: '↳ credentialsConfig'
           var_type: array