Discuss and implement - a new project page for AI

Created on 27 June 2025, 8 days ago

Problem/Motivation

The curerent project page of the AI module is outdated and does have way to much information saying way too little.

We need to rewrite it and restyle it.

There are some known considerations that should go into it now, that was not something we had to think about when we wrote it.

We have becomes the #1 SERP in Google and Bing for "Drupal AI" probably everywhere - I did try against SERP API and at least 80 regional combinations had us as #1. People that search for that term are probably decision makers trying to find information about what Drupal and AI can do for them or they are developers/site builder/PM's looking for how to integrate AI into their Drupal project.

The second target group are resilient and will not give up because the first results are marketing information and they also know how to combine their results for better result and they know about drupal.org.

Its very unlucky that the Drupal AI page is the first the decision makers are seing, because the design is outdated and the information is very technical and developer oriented - so we should add a link above the fold to make sure that that persona has a link to drupal.org/ai and to promote that to search engines.

The documentation on https://project.pages.drupalcode.org/ai/ is getting better, so we should forward developers to that documentation and rather focus on what the module solves on the project page.

We have to have:

  • What it does
  • Who can use it
  • Features

Good examples to look at for text/design:

Steps to reproduce

Proposed resolution

  1. Add a link above the fold to make sure that that persona has a link to drupal.org/ai and to promote that to search engines.
  2. Discuss what else should be there, how it should look at what need
πŸ“Œ Task
Status

Active

Version

1.2

Component

Documentation

Created by

πŸ‡©πŸ‡ͺGermany marcus_johansson

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

  • Issue created by @marcus_johansson
  • πŸ‡ͺπŸ‡ΈSpain gxleano CΓ‘ceres

    Another addition would be to have a link at the top like "Try it", "Try Drupal AI" or something pointing to https://www.drupalforge.org/template/drupal-cms-ai-demo, where users can "easily" test the Drupal AI features.

  • πŸ‡¬πŸ‡§United Kingdom pdjohnson Manchester

    Hi Marcus,

    thank you so much for your thoughtful insights. It is indeed the case that the page is the top performer on SEO. That is in many ways good, because we know where the majority of AI related traffic is landing.

    In a majority if cases I suspect the greater proportion of people visiting this page are new to Drupal AI, considering whether to use it be they developers, agencies or end customers of Drupal. On Slack others have cited https://www.drupal.org/project/webform β†’ as a good example page and it is clear that it is designed to "sell" webform by presenting rich feature set and a prominent video. It still has the important links to sub modules and issue queues, but most likely developers working with the module have bookmarked or memorised key pages.

    The Webform page has a content hierarchy where the most important topics are at the top along with clear calls to action signposting different audience types to their place. We could certainly consider following this model.

    There is a lot right about the existing Drupal AI page. The content is good and there are ample links out to the various modules. Those involved have done great work. With the launch of some and soon more pages dedicated to end users such as decision makers, marketers, other non technical audiences you rightly point out we impress the and signpost well. It is vital we hook these visitors onto Drupal at the early stage in evaluation be they developers or end customers. Each are equally important in our success.

    The pages the Drupal AI Initiative are building out are specifically intended to serve the end customer. What would be fantastic is if the Drupal AI project page could send them our way. Now is a good time to consider how we direct people to the best content for them.

    Rather than dive straight into editing the page, I suggest a first exercise would be to document what intents we think visitors from search engines to the page have. For example:

    1. Does Drupal AI have the features my business requires
    2. How do I host Drupal AI
    3. Where do I download AI module X
    4. Where is the documentation?
    5. Can I see some examples of other companies using Drupal AI?

    Taking time to collectively gather this information will help build a picture of what the structure of the new page layout could be.

    To make the page visually rich, 1xINTERNET can very likely get some design support to create some nice imagery once we are at the stage of building out the content.

Production build 0.71.5 2024