Skip to content

docs(forms): remove experimental framing from Signal Forms PACKAGE.md#68769

Closed
LeSingh1 wants to merge 2 commits into
angular:mainfrom
LeSingh1:docs-forms-signal-forms-graduation
Closed

docs(forms): remove experimental framing from Signal Forms PACKAGE.md#68769
LeSingh1 wants to merge 2 commits into
angular:mainfrom
LeSingh1:docs-forms-signal-forms-graduation

Conversation

@LeSingh1

Copy link
Copy Markdown

PR Checklist

PR Type

Documentation content changes

What is the current behavior?

Following the merge of #68581 (which graduated the Signal Forms APIs to public API) and #68654 (which removed experimental warnings from Signal Forms docs across adev), packages/forms/signals/PACKAGE.md still:

  • titled the API # 🚧 Experimental Signal-Based Forms API 🏗️;
  • described it in the opening paragraph as something we're using "to explore potential designs";
  • listed three items under Not yet supported that are now shipped:
    • Interop with Reactive/Template forms — see packages/forms/signals/src/compat/ and packages/forms/signals/src/controls/interop_ng_control.ts
    • Strongly-typed binding to UI controlsFormValueControl<T> and FormCheckboxControl are publicly exported (packages/forms/signals/src/directive/form_field.ts)
    • Debouncing validation — see packages/forms/signals/src/api/rules/debounce.ts
  • and called the API "early and still highly experimental" in the FAQ.

Per the contributor comment on #68724, the parent packages/forms/PACKAGE.md also still said you can build forms "in one of two ways" and listed only reactive + template-driven, when there are now three.

What is the new behavior?

Refreshed packages/forms/signals/PACKAGE.md to drop the experimental framing and removed the three now-supported items from the "Not yet supported" list. Kept Dynamic objects and Tuples since I could not verify those have shipped. The "early and still highly experimental" line in the FAQ is replaced with a no-op (the rest of that paragraph already captures the intended sentiment about incremental rollout).

Updated packages/forms/PACKAGE.md to say "three ways" and to introduce signal forms as the third option.

Issue Number: #68724

Following angular#68581 (which graduated Signal Forms APIs to public API) and
angular#68654 (which removed experimental warnings from Signal Forms docs across
adev), `packages/forms/signals/PACKAGE.md` still:

  * titled the API `🚧 Experimental Signal-Based Forms API 🏗️`;
  * described it as something used "to explore potential designs";
  * listed `Interop with Reactive/Template forms`, `Strongly-typed binding
    to UI controls`, and `Debouncing validation` under "Not yet supported"
    — these are all shipped (see `packages/forms/signals/src/compat/`,
    `controls/interop_ng_control.ts`, `FormValueControl` /
    `FormCheckboxControl`, and `src/api/rules/debounce.ts`);
  * called the API "early and still highly experimental" in the FAQ.

This change refreshes the page to reflect the graduated status. Items
that I could not verify as shipped (`Dynamic objects`, `Tuples`) are
kept under "Not yet supported".

The parent `packages/forms/PACKAGE.md` still said you can build forms
"in one of two ways"; updated to three to include signal forms.

Closes angular#68724

Signed-off-by: LeSingh1 <sshaurya914@gmail.com>
@pullapprove pullapprove Bot requested a review from kirjs May 18, 2026 01:34
@angular-robot angular-robot Bot added area: docs Related to the documentation area: forms labels May 18, 2026
@google-cla

google-cla Bot commented May 18, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@ngbot ngbot Bot added this to the Backlog milestone May 18, 2026
@LeSingh1

Copy link
Copy Markdown
Author

@googlebot I signed it!

Signed-off-by: LeSingh1 <sshaurya914@gmail.com>
@JeanMeche

Copy link
Copy Markdown
Member

Thanks for the suggestion, we'll update that document ourselves.

@JeanMeche JeanMeche closed this May 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Related to the documentation area: forms

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants