Skip to content

Docs: Organize Jetpack product documentation - #1

Draft
f wants to merge 12 commits into
docs/docspress-wordpress-com-pilotfrom
codex/docs-product-organization
Draft

Docs: Organize Jetpack product documentation#1
f wants to merge 12 commits into
docs/docspress-wordpress-com-pilotfrom
codex/docs-product-organization

Conversation

@f

@f f commented Jul 30, 2026

Copy link
Copy Markdown
Owner

Fixes #

Proposed changes

  • Add a top-level Products branch with a catalog-backed landing page and 13 lifecycle-oriented product hubs.
  • Add a Jetpack Developer Docs site adapter that owns a full-width, accessible product carousel without changing DocsPress, the DocsPress theme, or DocsPress Blocks.
  • Place the site-specific carousel directly below the documentation homepage hero and keep the existing role-oriented homepage sections below it.
  • Preserve all 69 baseline manifest IDs and routes while adding catalog, link, front matter, security, rendering, interaction, and deterministic-package validation.

Related product discussion/links

  • None.

Does this pull request change what data or activity we track or use?

No. The carousel is navigation-only and adds no analytics, storage, or new data collection.

Testing instructions

  • Run node tools/docspress/validate-developer-docs.mjs and confirm that 83 manifest pages, 69 preserved baseline routes, 13 product hubs, and one catalog-backed carousel pass.
  • Run node --test tools/docspress/jetpack-developer-docs-site/tests/*.test.cjs.
  • Run php tools/docspress/jetpack-developer-docs-site/tests/render-test.php.
  • Run tools/docspress/jetpack-developer-docs-site/package.sh twice and confirm the generated ZIPs are byte-identical and pass unzip -t.
  • Install the generated ZIP only on the mapped Jetpack Developer Docs staging site before synchronizing the homepage. Verify autoplay, hover and keyboard pause, drag suppression, reduced-motion, no-JavaScript fallback, and mobile/desktop layouts.
  • Run the existing Sync developer docs to WordPress.com workflow with dry_run: true and status: publish; require zero conflicts and zero unexpected deletions before publishing.

@github-actions

github-actions Bot commented Jul 30, 2026

Copy link
Copy Markdown

Thank you for your PR!

When contributing to Jetpack, we have a few suggestions that can help us test and review your patch:

  • ✅ Include a description of your PR changes.
  • ✅ Add a "[Status]" label (In Progress, Needs Review, ...).
  • ✅ Add testing instructions.
  • ✅ Specify whether this PR includes any changes to data or privacy.
  • ✅ Add changelog entries to affected projects

This comment will be updated as you work on your PR and make changes. If you think that some of those checks are not needed for your PR, please explain why you think so. Thanks for cooperation 🤖


Follow this PR Review Process:

  1. Ensure all required checks appearing at the bottom of this PR are passing.
  2. Make sure to test your changes on all platforms that it applies to. You're responsible for the quality of the code you ship.
  3. You can use GitHub's Reviewers functionality to request a review.
  4. When it's reviewed and merged, you will be pinged in Slack to deploy the changes to WordPress.com simple once the build is done.

If you have questions about anything, reach out in #jetpack-developers for guidance!

@f
f force-pushed the codex/docs-product-organization branch from 626b800 to a6e3e8c Compare July 30, 2026 21:09
@f
f force-pushed the codex/docs-product-organization branch from a6e3e8c to 6635a3d Compare July 30, 2026 21:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant