feat(docs-improvements): Homepage redesign pt 1 by lena-larionova · Pull Request #5873 · Kong/developer.konghq.com

lena-larionova · 2026-07-07T22:20:24Z

https://deploy-preview-5873--kongdeveloper.netlify.app/

netlify · 2026-07-07T22:20:29Z

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	`ca1efe1`
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/6a4eb859f0a25b000844a0c8
😎 Deploy Preview	https://deploy-preview-5873--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot

Pull request overview

This PR is the first part of a homepage redesign for the Kong Developer docs site, moving the homepage to a new section-based layout driven by a reorganized app/_data/homepage.yml.

Changes:

Reworked the homepage layout in app/index.html (new hero, agent/CLI section, product section, featured API specs, “What’s new”, and AI query chips).
Updated the Markdown-rendered homepage variant in app/index.md.html to match the new section model.
Restructured homepage content data in app/_data/homepage.yml (hero, agents section, product categories, featured API specs, and release entries) and adjusted the featured ribbon text color in app/_includes/card.html.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
app/index.md.html	Replaces the old `sections` loop with explicit homepage sections backed by the new data model.
app/index.html	Implements the new redesigned homepage UI and wiring for AI “chip” queries.
app/_includes/card.html	Adjusts featured ribbon text color for improved theme styling.
app/_data/homepage.yml	Introduces the new structured homepage data model (hero, agents/CLI cards, products, specs, and what’s new).

cloudjumpercat · 2026-07-08T19:30:15Z

+                <svg width="20" height="20" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+                    <path d="M20 12.0884V12.4355C15.7128 12.4355 14.5598 16.2296 14.5598 19.3252H14.2229C14.2229 16.2296 12.8732 12.4355 8.78272 12.4355V12.0884C13.497 12.0884 14.2229 8.29432 14.2229 5.19878H14.5598C14.5598 8.29432 15.2977 12.0884 20 12.0884ZM7.28629 11.0361C7.28629 9.27503 7.94267 7.11656 10.3813 7.11656V6.91952C7.70577 6.91952 7.28629 4.76104 7.28629 3H7.09502C7.09502 4.76104 6.68206 6.91952 4 6.91952V7.11656C6.32779 7.11656 7.09502 9.27503 7.09502 11.0361H7.28629ZM9.21089 14.1529H9.04788C9.04788 15.6531 8.69578 17.4925 6.41038 17.4925V17.6604C8.39367 17.6604 9.04788 19.4998 9.04788 21H9.21089C9.21089 19.4998 9.76948 17.6604 11.8484 17.6604V17.4925C9.56843 17.4925 9.21089 15.6531 9.21089 14.1529Z" fill="rgb(var(--color-text-secondary)"/>
+                </svg>
+                <span class="text-sm">Ask AI for concepts, guides, and tutorials</span>


Suggested change

Ask AI for concepts, guides, and tutorials

What do you want to build?

We have suggested topics below, I wanted to give this more of a vibe that Claude already does with the "What can I help you with today?" when you open a fresh chat.

Hopefully this makes it easier for someone to know "oh, I can explain what I'm trying to build here" vs "what sort of concept should I ask about?". Feels more action-oriented.

In a vacuum, I like this idea, but it looks weird right after the page title of "What do you want to accomplish?"

Suggested change

Ask AI for concepts, guides, and tutorials

Search concepts, guides, and tutorials

Good point. I've suggested an edit to the H1. FWIW, I think the h1 introduces the Ask AI well, but not the rest of the page.

The h1 + Ask AI chatbot is asking what you want to accomplish.

The following h2s share tools you can use and list products, they don't really tell you how to accomplish use cases, they just give you tools to do so.

cloudjumpercat · 2026-07-08T19:38:23Z

+  title: "From edge to agent"
+  title_italic: "agent"
+  categories:
+    - name: Connectivity


IMO (and this is a can of worms that cannot be solved before release, so not blocking) we focus too much on listing stuff out by product.

I wonder if this, and the whole docs set, would benefit from more of a "what are you trying to do" vs. "pick your product" focus.

Definitely a can of worms that we're not ready for. The focus for now has to be the CLIs + agent tools section

cloudjumpercat · 2026-07-08T20:00:30Z

-          - text: All documentation
-            url: /index/catalog/
+products_section:
+  title: "From edge to agent"


Suggested change

title: "From edge to agent"

title: "Manage the entire AI connectivity layer"

I'm not quite happy with this revision. Point being, I wanted something about how this is the AI connectivity path in one central (ish) area, so you can manage the entire path.

cloudjumpercat · 2026-07-08T20:22:46Z

+    - product: gateway
+      version_override: "3.15.0.0"
+      changelog_url: /gateway/changelog/
+    - product: event-gateway


Suggested change

- product: event-gateway

- product: konnect

changelog_url: https://releases.konghq.com/

- product: event-gateway

I don't know if this will work, but it felt odd to have nothing for Konnect

Let me play around with this a bit.

Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

cloudjumpercat · 2026-07-08T21:08:31Z

+        <p class="font-mono text-xs uppercase tracking-widest text-terciary m-0">Kong Developer · <span class="bg-brand text-button px-1">Documentation</span></p>
+        <div class="flex flex-col gap-4">
+            <h1 class="font-extrabold text-[72px] leading-[84px] [contain:layout:style]">
+                What do you want to <br><em class="text-primary dark:text-brand italic">accomplish?</em>


Suggested change

What do you want to accomplish?

What do you want to build?

draft of homepage

97af7c7

lena-larionova added 6 commits July 7, 2026 16:09

lots more edits

dec0d1f

hide hero image on mobile

2205c28

center header and remove hero image

b56c46b

light mode + adjustments

a809352

add versions and what's new

3d0e5b9

adjustments for kapa

fe59744

lena-larionova marked this pull request as ready for review July 8, 2026 18:47

lena-larionova requested a review from a team as a code owner July 8, 2026 18:47

Copilot AI review requested due to automatic review settings July 8, 2026 18:47

Copilot started reviewing on behalf of lena-larionova July 8, 2026 18:47 View session

Copilot AI reviewed Jul 8, 2026

View reviewed changes

Comment thread app/index.html Outdated

Comment thread app/index.html Outdated

Comment thread app/index.html Outdated

review feedback

ef9e11d

cloudjumpercat reviewed Jul 8, 2026

View reviewed changes

lena-larionova and others added 3 commits July 8, 2026 13:25

more cleanup + consistency

b03427a

Apply suggestions from code review

c6dd7bf

Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

fix md output

ca1efe1

cloudjumpercat reviewed Jul 8, 2026

View reviewed changes

	<span class="text-sm">Ask AI for concepts, guides, and tutorials</span>
	<span class="text-sm">What do you want to build?</span>

	<span class="text-sm">Ask AI for concepts, guides, and tutorials</span>
	<span class="text-sm">Search concepts, guides, and tutorials</span>

	title: "From edge to agent"
	title: "Manage the entire AI connectivity layer"

	What do you want to <br><em class="text-primary dark:text-brand italic">accomplish?</em>
	What do you want to <br><em class="text-primary dark:text-brand italic">build?</em>

Uh oh!

Conversation

lena-larionova commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for kongdeveloper ready!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lena-larionova commented Jul 7, 2026 •

edited

Loading

netlify Bot commented Jul 7, 2026 •

edited

Loading