Page MenuHomePhabricator

Community Configuration: optional fields should be indicated with optionalFlag
Open, MediumPublic

Description

Background:

Previously we were indicating required fields with an asterisk, see below:

Screen Shot 2024-04-29 at 5.07.30 PM.png (468×1 px, 92 KB)

The only two required fields in all Community Configuration are inside of the Newcomer homepage form:

  • Destination page for a link about creating a new article
  • Destination page for a link about how to add images in the visual editor

Following the Codex form guidelines, it is not recommended to mark fields as required with an asterisk, it is advisable to indicate the optional fields instead. Therefore we should be indicating all other fields as optional.

All fields in a form are inherently required. Consider omitting fields that don’t feel absolutely necessary, to emphasize this notion. When a field is optional, it should be accompanied by the word “(optional)” next to the label. This functionality is built into the Label component.

The optional indicator is already built inside of the Label component (optionalFlag); see Field demo in the Codex site.

Acceptance criteria
  • Add the optional indicator to all optional fields.

Event Timeline