Please review the names of the new methods that are being introduced with the fields feature. JFormField got three new methods and the names of all of those methods are not self-explanatory. I expect that you look at a method name and together with the class name can deduce what this method is doing, like JRouter::parse() or JViewLegacy::display().

If that really, REALLY is not possible, then at least add extensive comments to the methods. In #12968 several component helper classes get a new method named "getRealSection". That name has absolutely zero meaning for me. Even when I look at the code, I have no idea what this is for. But when I read the doc block, I get the following

 	/**
	 * Map the section for custom fields.
	 *
	 * @param   string  $section  The section to get the mapping for
	 *
	 * @return  string  The new section
	 *
	 * @since   __DEPLOY_VERSION__
	 */

This doc block does not describe anything. What is a section? What is this for? Is this made for com_finder or K2? What does it map the section from and to? If this code is released like this, in a years time no one will know what this does and/or what this is for. Neither from the code nor from the doc block it is understandeable that this takes the context of a form and based on the component and front- or backend translates it into the actual form context that is being used. The doc blocks in JFormField are equally non-descriptive.

This is part of a code review of the fields feature. See #13222, #13223 and other connected issues.