Follow-up to #2805097: Should the YAML form module change its name?

Problem/Motivation

The YAML Form namespace is potentially confusing. Clients and site builders don't need to under YAML to builder forms. The Drupal development community is familiar with YAML and are able to edit forms as YAML.

Proposed resolution

Keep the module's project title as "YAML Form" but within Drupal's UI refer to forms as forms (not YAML Forms).

Notes

  • Wordpress has the same issue with GravityForms and NinjaForms which both module install using the 'Forms' project title but each add-on has a dedicated namespaces.
  • The YAML Form project's routes will have to remain as 'yamlform'.
  • This is reasonable because most Drupal sites will only use one form builder.

Development Notes

  • Branch Name: 2808675-rename-project-title
  • Commit message: Issue #2808675: Rename "YAML Form" to "Forms" within Drupal's UI.
CommentFileSizeAuthor
#10 rename_yaml_form_to-2808675-10.patch467.5 KBjrockowitz
#8 rename_yaml_form_to-2808675-8.patch461.22 KBjrockowitz
#5 Screen Shot 2016-09-29 at 2.27.07 PM.png183.54 KBjrockowitz

Comments

jrockowitz created an issue. See original summary.

jrockowitz’s picture

jrockowitz commented
Issue summary: View changes
jrockowitz’s picture

jrockowitz commented
Priority: Normal » Major

Changing Priority to Major since this needs to be done ASAP.

  • jrockowitz committed ffc3889 on 2808675-rename-project-title 
    Issue #2808675: Rename "YAML Form" to "Forms" within Drupal's UI.
jrockowitz’s picture

jrockowitz commented
Status: Active » Needs review
StatusFileSize
new Screen Shot 2016-09-29 at 2.27.07 PM.png183.54 KB

Please checkout the '2808675-rename-project-title' branch to review this issue.

I think this is a major shift from the common practice that a module's title and namespace are the same. This change would benefit site builders while adding a little more confusion to developers.

If Drupal core does decide to use the 'Forms' namespace using the name 'Forms' within this module's menu links and page titles could cause some problems.

jrockowitz’s picture

jrockowitz commented

One immediate issue is that all tokens would have to remain as [yamlform] and [yamlform-submission]

  • jrockowitz committed 4612978 on 2808675-rename-project-title 
    Issue #2808675: Rename "YAML Form" to "Forms" within Drupal's UI.
jrockowitz’s picture

jrockowitz commented
StatusFileSize
new rename_yaml_form_to-2808675-8.patch461.22 KB

  • jrockowitz committed 51352e7 on 2808675-rename-project-title 
    Issue #2808675: Rename "YAML Form" to "Forms" within Drupal's UI.
jrockowitz’s picture

jrockowitz commented
StatusFileSize
new rename_yaml_form_to-2808675-10.patch467.5 KB
jrockowitz’s picture

jrockowitz commented
Issue summary: View changes

  • jrockowitz committed 8a5a520 on 8.x-1.x 
    Issue #2808675 by jrockowitz: Rename "YAML Form" to "Forms" within...
jrockowitz’s picture

jrockowitz commented
Title: Rename "YAML Form" to "Forms" within Drupal's UI. » Refe to "YAML Form" to "Forms" and "YAML Form Submissions" as "Submissions" within Drupal's UI.
Status: Needs review » Fixed

This change has actually improved my personal user experience, while navigating around my own module. So I going to commit to this change and we can gradually fix any minor editorial issues as they come up.

My gut says that Drupal core won't occupy the 'Forms' namespace until Drupal 9.x which won't be for a few years. When and if there is a naming conflict with the 'Forms' namespace, the YAML Form module's menu links and breadcrumbs will need to be changed to back "YAML Forms". Within the module it will still be okay to refer to forms as 'Forms' and submissions as 'Submissions'.

jrockowitz’s picture

jrockowitz commented
Title: Refe to "YAML Form" to "Forms" and "YAML Form Submissions" as "Submissions" within Drupal's UI. » Refe to "YAML Form" as "Forms" and "YAML Form Submissions" as "Submissions" within Drupal's UI.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.