Article API: simplify GitHub Apps permissions token indicators (#60075)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: heiskr

src/article-api/tests/github-apps-transformer.ts

@@ -164,9 +164,12 @@ describe('GitHub Apps transformer', () => {
       const res = await get(makeURL('/en/rest/authentication/permissions-required-for-github-apps'))
       expect(res.statusCode).toBe(200)
 
-      // Check for IAT and UAT links in Tokens column
-      expect(res.body).toMatch(/\[IAT\]\(\/en\/apps\/creating-github-apps\//)
-      expect(res.body).toMatch(/\[UAT\]\(\/en\/apps\/creating-github-apps\//)
+      // Check for legend
+      expect(res.body).toContain('UAT = user access token')
+      expect(res.body).toContain('IAT = installation access token')
+
+      // Check that token types appear in actual table rows (not just the legend)
+      expect(res.body).toMatch(/\|\s*(?:UAT|IAT|UAT, IAT|None)\s*\|/)
     })
 
     test('table shows additional permissions with checkmark/cross', async () => {
@@ -221,8 +224,6 @@ describe('GitHub Apps transformer', () => {
 
       // Check that AUTOTITLE has been resolved
       expect(res.body).not.toContain('[AUTOTITLE]')
-      // Should have actual link text
-      expect(res.body).toMatch(/\[.*?\]\(\/en\/apps\//)
     })
 
     test('API version parameter is supported', async () => {

src/article-api/transformers/github-apps-transformer.ts

@@ -173,28 +173,31 @@ export class GithubAppsTransformer implements PageTransformer {
         introMarkdown += `${templateData.manualContent}\n\n`
       }
 
+      // Add token type legend (only for GitHub App permissions, not fine-grained PAT)
+      if (pageType === 'server-to-server-permissions') {
+        introMarkdown += `**Token types:** UAT = user access token, IAT = installation access token\n\n`
+      }
+
       // Build the tables manually
       let tablesMarkdown = ''
       for (const item of templateData.items as PreparedPermissionItem[]) {
         tablesMarkdown += `## ${item.displayTitle}\n\n`
         tablesMarkdown += '| Endpoint | Access | Tokens | Additional Permissions |\n'
         tablesMarkdown += '|----------|--------|--------|------------------------|\n'
 
+        const isFineGrainedPat = pageType === 'fine-grained-pat-permissions'
+
         for (const perm of item.permissions) {
-          const lang = context.currentLanguage || 'en'
-          const version =
-            context.currentVersion === 'free-pro-team@latest' ? '' : `${context.currentVersion}/`
-          const endpoint = `[\`${perm.verb} ${perm.requestPath}\`](/${lang}/${version}rest/${perm.category}#${perm.slug})`
-
-          let tokens = ''
-          if (perm.userToServer) {
-            tokens += `[UAT](/${lang}/${version}apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)`
-          }
-          if (perm.userToServer && perm.serverToServer) {
-            tokens += '<br>'
-          }
-          if (perm.serverToServer) {
-            tokens += `[IAT](/${lang}/${version}apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app-installation)`
+          const endpoint = `\`${perm.verb} ${perm.requestPath}\``
+
+          let tokens: string
+          if (isFineGrainedPat) {
+            tokens = 'PAT'
+          } else {
+            const tokenParts: string[] = []
+            if (perm.userToServer) tokenParts.push('UAT')
+            if (perm.serverToServer) tokenParts.push('IAT')
+            tokens = tokenParts.join(', ') || 'None'
           }
 
           const additionalPerms = perm.additionalPermissions ? '✓' : '✗'