Skip to content

Conversation

@opr
Copy link
Contributor

@opr opr commented Oct 14, 2025

Changes proposed in this Pull Request:

  • Update autocomplete docs to clarify they apply to Checkout block too

How to test the changes in this Pull Request:

Using the WooCommerce Testing Instructions Guide, include your detailed testing instructions:

  1. Observe docs change and ensure no typos etc.

Testing that has already taken place:

Changelog entry

  • Automatically create a changelog entry from the details below.
  • This Pull Request does not require a changelog entry. (Comment required below)
Changelog Entry Details

Significance

  • Patch
  • Minor
  • Major

Type

  • Fix - Fixes an existing bug
  • Add - Adds functionality
  • Update - Update existing functionality
  • Dev - Development related task
  • Tweak - A minor adjustment to the codebase
  • Performance - Address performance issues
  • Enhancement - Improvement to existing functionality

Message

Changelog Entry Comment

Comment

@opr opr requested a review from a team as a code owner October 14, 2025 09:56
@opr opr added Documentation Issues and PRs related to improving documentation Rubik Store API checkout endpoints, Mini-Cart, Cart and Checkout related issues labels Oct 14, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Oct 14, 2025

Testing Guidelines

Hi @straku @woocommerce/developer-advocacy,

Apart from reviewing the code changes, please make sure to review the testing instructions (Guide) and verify that relevant tests (E2E, Unit, Integration, etc.) have been added or updated as needed.

Reminder: PR reviewers are required to document testing performed. This includes:

  • 🖼️ Screenshots or screen recordings.
  • 📝 List of functionality tested / steps followed.
  • 🌐 Site details (environment attributes such as hosting type, plugins, theme, store size, store age, and relevant settings).
  • 🔍 Any analysis performed, such as assessing potential impacts on environment attributes and other plugins, conducting performance profiling, or using LLM/AI-based analysis.

⚠️ Within the testing details you provide, please ensure that no sensitive information (such as API keys, passwords, user data, etc.) is included in this public issue.

@github-actions github-actions bot added the plugin: woocommerce Issues related to the WooCommerce Core plugin. label Oct 14, 2025
@woocommercebot woocommercebot requested review from a team and straku and removed request for a team October 14, 2025 09:56
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Oct 14, 2025

📝 Walkthrough

Walkthrough

Documentation updates clarify that the address autocomplete provider will be registered for both shortcode and block-based checkouts. A changelog entry notes that only docs were updated. No code, tests, or functional behavior changes.

Changes

Cohort / File(s) Summary
Docs: Address Autocomplete
docs/features/address-autocomplete/address-autocomplete.md
Revised statement from shortcode-only support to include block-based checkout registration. Text-only documentation change.
Plugin Changelog (Docs-only)
plugins/woocommerce/changelog/update-autocomplete-docs
Changelog entry noting documentation-only update with no code or API changes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Title Check ✅ Passed The pull request title accurately conveys the main change by stating that the autocomplete documentation has been updated to include support for the Checkout block alongside the shortcode implementation, and it is concise and clear about the update’s focus.
Description Check ✅ Passed The pull request description clearly outlines the proposed documentation change and includes testing instructions relevant to verifying the update, making it directly related to the changeset.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch update/autocomplete-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (1)
docs/features/address-autocomplete/address-autocomplete.md (1)

7-7: Clarify the block checkout naming.

Suggest rephrasing to “both the classic shortcode checkout and the Checkout block” so readers immediately connect the note with the official block name called out in the PR title.

📜 Review details

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d80cd1d and dbde627.

📒 Files selected for processing (2)
  • docs/features/address-autocomplete/address-autocomplete.md (1 hunks)
  • plugins/woocommerce/changelog/update-autocomplete-docs (1 hunks)
🧰 Additional context used
🧠 Learnings (3)
📓 Common learnings
Learnt from: opr
PR: woocommerce/woocommerce#60776
File: docs/features/address-autocomplete/address-autocomplete.md:172-209
Timestamp: 2025-09-04T22:01:17.403Z
Learning: For WooCommerce address autocomplete provider documentation, keep code examples simple and focused on the core concepts rather than including all WordPress security and best practices, as plugin authors can figure out implementation details themselves.
Learnt from: opr
PR: woocommerce/woocommerce#60891
File: plugins/woocommerce/client/blocks/assets/js/base/components/cart-checkout/address-autocomplete/address-autocomplete.tsx:62-79
Timestamp: 2025-09-24T13:44:37.668Z
Learning: In WooCommerce address autocomplete (plugins/woocommerce/client/blocks/assets/js/base/components/cart-checkout/address-autocomplete/address-autocomplete.tsx), providers should have full control over address data returned from their select method, including overwriting existing fields with empty values. Merging with existing cart address data is not the intended behavior when providers return empty or undefined values.
📚 Learning: 2025-09-04T22:01:17.403Z
Learnt from: opr
PR: woocommerce/woocommerce#60776
File: docs/features/address-autocomplete/address-autocomplete.md:172-209
Timestamp: 2025-09-04T22:01:17.403Z
Learning: For WooCommerce address autocomplete provider documentation, keep code examples simple and focused on the core concepts rather than including all WordPress security and best practices, as plugin authors can figure out implementation details themselves.

Applied to files:

  • docs/features/address-autocomplete/address-autocomplete.md
📚 Learning: 2025-09-24T13:44:37.668Z
Learnt from: opr
PR: woocommerce/woocommerce#60891
File: plugins/woocommerce/client/blocks/assets/js/base/components/cart-checkout/address-autocomplete/address-autocomplete.tsx:62-79
Timestamp: 2025-09-24T13:44:37.668Z
Learning: In WooCommerce address autocomplete (plugins/woocommerce/client/blocks/assets/js/base/components/cart-checkout/address-autocomplete/address-autocomplete.tsx), providers should have full control over address data returned from their select method, including overwriting existing fields with empty values. Merging with existing cart address data is not the intended behavior when providers return empty or undefined values.

Applied to files:

  • docs/features/address-autocomplete/address-autocomplete.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Remind reviewers to also review the testing instructions and test coverage

Copy link
Contributor

@straku straku left a comment

Choose a reason for hiding this comment

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

👍

@opr opr merged commit df710da into trunk Oct 14, 2025
26 of 28 checks passed
@opr opr deleted the update/autocomplete-docs branch October 14, 2025 10:12
@github-actions github-actions bot added this to the 10.4.0 milestone Oct 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Issues and PRs related to improving documentation plugin: woocommerce Issues related to the WooCommerce Core plugin. Rubik Store API checkout endpoints, Mini-Cart, Cart and Checkout related issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants