Come together with the global Drupal community in Rotterdam, 28 Sept – 1 Oct 2026. Sessions, contribution, connection, and Early Bird savings until 8 June.Problem/Motivation
We have a bunch of open issues against the Form API reference. Some may apply to Drupal 8, and some may not.
Proposed resolution
Once we have completed the other child issues of #2486967: [meta] Move/Create Form Element Documentation, we should go through the open issues filed against the old Form API reference, and see if any of them apply to the Drupal 8 form/render element/property documentation.
These issues can be found in:
- Project: Documentation
- Component: API documentation files
- Tag: FAPI reference
Here's a search link:
https://www.drupal.org/project/issues/search/documentation?status[]=Open...
Remaining tasks
The project here would be:
a) Read through each issue and understand the problem it is reporting.
b) See if the issue applies to Drupal 8. The problem may not exist in Drupal 8 -- it may have already been fixed up, or it may not apply. Note that in Drupal 8, docs about specific form/render elements should live on the specific form/render element class page, while docs about generic form/render element properties should live on the base FormElement and RenderElement classes. Or at least, there should be a link from those classes to some other class/method/topic where the property is fully documented.
c) If it is a problem that needs to be addressed in Drupal 8, either move the issue to Drupal Core or file a separate issue to fix the problem there. Note where the docs that need updating are located (which class or topic file).
d) If the problem does not apply to Drupal 8, make a note on the issue that it only applies to earlier versions and move on to the next one. Put a line at the top of the issue summary stating which versions it applies to, so that it is easily noticeable.
User interface changes
No.
API changes
No.
Data model changes
No.
Comments
Comment #2
jhodgdonPostponing until the other issues are done.
Comment #16
smustgrave commentedThank you for creating this issue to improve Drupal.
We are working to decide if this task is still relevant to a currently supported version of Drupal. There hasn't been any discussion here for over 8 years which suggests that this has either been implemented or is no longer relevant. Your thoughts on this will allow a decision to be made.
Since we need more information to move forward with this issue, the status is now Postponed (maintainer needs more info). If we don't receive additional information to help with the issue, it may be closed after three months.
Thanks!
Comment #17
smustgrave commentedProbably still valid. Not 100% we need a meta for it but will leave open.
Comment #18
quietone commentedThis about finding issue filed against the Form API reference that apply to Drupal 8. The search link in the issue summary returns 0 open issues.
I think it best to close as a duplicate.