Fix collection documentation tab crash caused due to missing docs_blob field (#3133)

Author: marshmalien

frontend/hub/collections/CollectionPage/CollectionContents.tsx

@@ -32,7 +32,7 @@ export function CollectionContents() {
       collection.collection_version?.name || ''
     }&namespace=${collection.collection_version?.namespace || ''}&version=${
       collection.collection_version?.version || ''
-    }`
+    }&exclude_fields=files,manifest,docs_blob`
   );
 
   const tableColumns = useTableColumns(collection);

frontend/hub/collections/CollectionPage/CollectionDocumentation.test.tsx

@@ -123,6 +123,39 @@ describe('CollectionDocumentation', () => {
   afterAll(() => server.close());
   afterEach(() => server.resetHandlers());
 
+  test('should request docs_blob by including exclude_fields in API URL', async () => {
+    let capturedUrl = '';
+    server.use(
+      http.get(
+        ({ request }) => {
+          return request.url.includes('/content/ansible/collection_versions/');
+        },
+        ({ request }) => {
+          capturedUrl = request.url;
+          return HttpResponse.json(mockDocumentationResponse);
+        }
+      )
+    );
+
+    render(
+      <TestWrapper>
+        <CollectionDocumentation />
+      </TestWrapper>
+    );
+
+    await waitFor(() => {
+      expect(capturedUrl).toContain('exclude_fields=');
+    });
+
+    const url = new URL(capturedUrl);
+    const excludeFields = url.searchParams.get('exclude_fields');
+    expect(excludeFields).toBeTruthy();
+    expect(excludeFields).toContain('files');
+    expect(excludeFields).toContain('manifest');
+    expect(excludeFields).toContain('contents');
+    expect(excludeFields).not.toContain('docs_blob');
+  });
+
   test('should render documentation tab with readme content', async () => {
     render(
       <TestWrapper>

frontend/hub/collections/CollectionPage/CollectionDocumentation.tsx

@@ -45,7 +45,7 @@ export function CollectionDocumentation() {
       collection?.collection_version?.namespace || ''
     }&name=${collection?.collection_version?.name || ''}&version=${
       collection?.collection_version?.version || ''
-    }&offset=0&limit=1`
+    }&offset=0&limit=1&exclude_fields=files,manifest,contents`
   );
 
   // create groups for left tab of contents menu

frontend/hub/collections/CollectionPage/CollectionInstall.test.tsx

@@ -126,6 +126,70 @@ describe('CollectionInstall', () => {
   afterAll(() => server.close());
   afterEach(() => server.resetHandlers());
 
+  test('should request docs_blob by including exclude_fields in API URL', async () => {
+    let capturedUrl = '';
+    server.use(
+      http.get(
+        ({ request }) => {
+          return request.url.includes('/content/ansible/collection_versions/');
+        },
+        ({ request }) => {
+          capturedUrl = request.url;
+          return HttpResponse.json(mockContentResponse);
+        }
+      )
+    );
+
+    render(
+      <TestWrapper>
+        <CollectionInstall />
+      </TestWrapper>
+    );
+
+    await waitFor(() => {
+      expect(capturedUrl).toContain('exclude_fields=');
+    });
+
+    const url = new URL(capturedUrl);
+    const excludeFields = url.searchParams.get('exclude_fields');
+    expect(excludeFields).toBeTruthy();
+    expect(excludeFields).toContain('files');
+    expect(excludeFields).toContain('manifest');
+    expect(excludeFields).toContain('contents');
+    expect(excludeFields).not.toContain('docs_blob');
+  });
+
+  test('should handle missing docs_blob gracefully', async () => {
+    server.use(
+      http.get(
+        ({ request }) => request.url.includes('/content/ansible/collection_versions/'),
+        () =>
+          HttpResponse.json({
+            count: 1,
+            next: '',
+            previous: '',
+            results: [
+              {
+                license: ['MIT'],
+              },
+            ],
+          })
+      )
+    );
+
+    render(
+      <TestWrapper>
+        <CollectionInstall />
+      </TestWrapper>
+    );
+
+    await waitFor(() => {
+      expect(screen.getByRole('heading', { name: 'Install' })).toBeInTheDocument();
+    });
+
+    expect(screen.queryByRole('link', { name: /go to documentation/i })).not.toBeInTheDocument();
+  });
+
   test('should render install information with license', async () => {
     render(
       <TestWrapper>

frontend/hub/collections/CollectionPage/CollectionInstall.tsx

@@ -41,7 +41,7 @@ export function CollectionInstall() {
       collection?.collection_version?.namespace || ''
     }&name=${collection?.collection_version?.name || ''}&version=${
       collection?.collection_version?.version || ''
-    }&offset=0&limit=1`
+    }&offset=0&limit=1&exclude_fields=files,manifest,contents`
   );
 
   const content = contentResults?.results[0];

frontend/hub/collections/CollectionPage/CollectionPage.tsx

@@ -68,7 +68,7 @@ export function CollectionPage() {
           collection?.collection_version?.namespace || ''
         }&name=${collection?.collection_version?.name || ''}&version=${
           collection?.collection_version?.version || ''
-        }&offset=0&limit=1`
+        }&offset=0&limit=1&exclude_fields=files,manifest,docs_blob,contents`
       : ''
   );
   const content = contentResults?.results?.[0];

playwright/tests/integration/automation-content/collections/collection-details.spec.ts

@@ -673,6 +673,46 @@ test.describe('Hub Collections - Details Page', () => {
     );
   });
 
+  test.describe('Documentation Tab', () => {
+    test(
+      'should render documentation content without error',
+      { tag: ['@not_mock'] },
+      async ({ page, collection }) => {
+        const namespace = 'e2edocs';
+        const name = 'docstab';
+
+        await collection.createNamespace({ name: namespace });
+        const uploaded = await collection.uploadVersion({
+          namespace,
+          name,
+          version: '1.0.0',
+          repository: 'staging',
+        });
+
+        await collection.approveCollection({
+          namespace: uploaded.namespace,
+          name: uploaded.name,
+          version: uploaded.version,
+        });
+
+        await navigateToCollectionDetails(page, uploaded);
+
+        // Click on the Documentation tab
+        await page.getByRole('tab', { name: 'Documentation' }).click();
+
+        // Verify documentation content renders (not an error state)
+        await expect(page.getByRole('heading', { name: 'Page not found' })).not.toBeVisible();
+
+        // Verify the page does not show a generic error boundary
+        const mainContent = page.locator('main');
+        await expect(mainContent).not.toContainText('Error', { timeout: 10000 });
+
+        // Verify documentation structure rendered (drawer with navigation panel)
+        await expect(page.getByPlaceholder('Find content')).toBeVisible({ timeout: 10000 });
+      }
+    );
+  });
+
   test.describe('Deprecation', () => {
     test(
       'should deprecate and undeprecate a collection from detail page',