Skip to content

Add/wporg reqs#78

Merged
jeffpaul merged 8 commits intotrunkfrom
add/wporg-reqs
Nov 19, 2025
Merged

Add/wporg reqs#78
jeffpaul merged 8 commits intotrunkfrom
add/wporg-reqs

Conversation

@jeffpaul
Copy link
Copy Markdown
Member

@jeffpaul jeffpaul commented Nov 14, 2025

What?

Relates to #28.

This pull request updates the plugin's branding and documentation to clarify its purpose as "AI Experiments" for WordPress, improves consistency across files, and updates metadata to match current project standards. The changes mainly affect documentation, plugin headers, and package configuration files.

Branding and Documentation Updates:

  • Renamed the plugin from "WordPress AI Experiments" to "AI Experiments" throughout README.md, readme.txt, ai.php, composer.json, and package.json for clarity and consistency. [1] [2] [3] [4]
  • Updated plugin descriptions, tags, and changelog entries to refer to "experiments" and "capabilities" instead of "features", and clarified the plugin's experimental nature. [1] [2] [3] [4]
  • Added project badges, a banner image, and improved the introductory section in README.md for better project visibility and professionalism.

Metadata and Requirements:

  • Updated minimum WordPress version requirement to 6.9 in ai.php and readme.txt, and ensured license references use the SPDX identifier for consistency. [1] [2]
  • Added a repository field to package.json to provide a direct link to the GitHub repository.

Cleanup:

  • Removed redundant or outdated license sections from README.md to avoid duplication and confusion.

Why?

Prepares plugin for WPORG standards ahead of submitting a 0.1.0 version to the WPORG Plugin Team for review.

How?

Testing Instructions

Testing Instructions for Keyboard

Screenshots or screencast

Before After

Test using WordPress Playground

The changes in this pull request can be previewed and tested using this WordPress Playground instance:

Click here to test this pull request.

@jeffpaul jeffpaul added this to the 0.1.0 milestone Nov 14, 2025
@jeffpaul jeffpaul self-assigned this Nov 14, 2025
@jeffpaul jeffpaul moved this to Needs review in WordPress AI Planning & Roadmap Nov 14, 2025
@jeffpaul jeffpaul marked this pull request as ready for review November 14, 2025 14:38
@github-actions
Copy link
Copy Markdown

github-actions bot commented Nov 14, 2025

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: jeffpaul <jeffpaul@git.wordpress.org>
Co-authored-by: JasonTheAdams <jason_the_adams@git.wordpress.org>
Co-authored-by: dkotter <dkotter@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@jeffpaul jeffpaul mentioned this pull request Nov 14, 2025
* @wordpress-plugin
* Plugin Name: AI
* Plugin Name: AI Experiments
* Plugin URI: https://github.com/WordPress/ai
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if it would be better to use an ai-experiments slug, as we are everywhere else, to continue to make it clear this really isn't intended as a production plugin. What do you think?

Copy link
Copy Markdown
Collaborator

@dkotter dkotter Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I flagged this in the initial scaffold PR as using the slug ai feels pretty generic / prone to conflicts (particularly in some of the constant names we have). I'd still recommend ai-experiments (if we can) instead noting if we do agree on that, we'll need to update our textdomain and probably other places

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have the ai slug reserved on WPORG, but we can still set the displayname to AI Experiments

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But why use up that slug for something experimental? Feels like it could be used by something intended for production later, like a canonical plugin?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the canonical plugin, if something graduates from an experiment it's either going to core or we'd label it as such in this plugin. I do not see a world where there's and Experiments plugin and a non-experiments plugin for AI, the confusion that would cause seems not worth the separation in plugins.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see. So we wouldn't make another one, we'd graduate this one from experimental to non-experimental. Thanks! 👍

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I flagged this in the initial scaffold PR as using the slug ai feels pretty generic / prone to conflicts (particularly in some of the constant names we have). I'd still recommend ai-experiments (if we can) instead noting if we do agree on that, we'll need to update our textdomain and probably other places

@dkotter we've got the ai slug reserved on WPORG with the intent that the display name will be AI Experiments. We could update to an ai-experiments slug (php file, package, composer) if you feel that's best?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, I'm not overly worried about those things. Constants worry me a bit as it seems a high likelihood of conflicting when we're setting those as AI_ but that doesn't need to be changed here

Copy link
Copy Markdown
Member

@JasonTheAdams JasonTheAdams left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couple suggestions, @jeffpaul, based on our conversation around the .org slug.

jeffpaul and others added 2 commits November 17, 2025 16:23
Co-authored-by: Jason Adams <jason.adams@automattic.com>
Copy link
Copy Markdown
Collaborator

@dkotter dkotter left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me, though noting since we're changing our minimum WP version from 6.8 to 6.9, if we merge this prior to 6.9 being released, you won't be able to install this plugin unless you're running a beta version of WP (which is why we changed it from 6.9 to 6.8 previously as it wouldn't install within Playgrounds)

Copy link
Copy Markdown
Member

@JasonTheAdams JasonTheAdams left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @jeffpaul!

@JasonTheAdams
Copy link
Copy Markdown
Member

Looks good to me, though noting since we're changing our minimum WP version from 6.8 to 6.9, if we merge this prior to 6.9 being released, you won't be able to install this plugin unless you're running a beta version of WP (which is why we changed it from 6.9 to 6.8 previously as it wouldn't install within Playgrounds)

I'm personally fine with this, given that it would do very little without Abilities, 6.9 will be releasing soon, and most people experimenting with this will know how to install the RC.

@jeffpaul jeffpaul merged commit 076cb34 into trunk Nov 19, 2025
20 of 27 checks passed
@jeffpaul jeffpaul deleted the add/wporg-reqs branch November 19, 2025 02:15
@github-project-automation github-project-automation bot moved this from Needs review to Done in WordPress AI Planning & Roadmap Nov 19, 2025
@jeffpaul jeffpaul linked an issue Nov 19, 2025 that may be closed by this pull request
8 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

Plugin submission to WordPress.org

3 participants