Use of word "fungates"

Events happening in the community are now at Drupal community events on www.drupal.org.
charles belov's picture

I noticed the following language in the hook documentation comment of a module hook-alter:

Function that fungates as last resort to alter the pre_render build.

/**
* Implements hook_field_group_pre_render().
* Function that fungates as last resort to alter the pre_render build.
*/

The only definitions I can find for "fungates" have to do with fungus, which I doubt is what is intended. But I get lots of search results if I search on Drupal and fungates, so it's apparently in common use.

Is this some technical term which has been insufficiently documented (which could present an issue to people who are limited English proficient or folks like me who have simply never encountered the term) or is it some long-ago auto-correct error that has managed to propagate itself through the Drupal ecosphere?

In either case, it might be a better practice to substitute some other more-widely-understood term, such as "serves."

/**
* Implements hook_field_group_pre_render().
* Function that serves as last resort to alter the pre_render build.
*/

I'm posting this in Groups rather than as an issue because (1) I don't know if this is something legitimate that was settled long ago or (2) since it appears in hook-alters rather than in core or a specific module, I don't know what I would file it against.

Comments

Funny!

xurizaemon's picture

That is funny. It looks like the origin may be a typo in the docs in field_group @ 241614ebce.

Agree with your proposed change, which would go to Field Group module, and then that issue could be used to reference in any modules which have inherited that meaning.

I think you could go further; "function that serves" seems doubly redundant; that it's a function needs no documenting, and "serve" adds little meaning when referring to a function; so you could say "Alter before rendering" or "Last resort to before rendering"

(but if we say last resort, we want to be certain that there are no later options, so I suspect that may be a misdirection ... It's possible to overthink these things...)

Agree "fungates" ain't right there :)

If my comments have helped you, please pay it forward!
Use issue queues to discuss module issues - this will help your questions assist others (including yourself!) in future.

Many thanks!

charles belov's picture

Many thanks both for the detective work and for the analysis. I've filed the issue as #3163397 Possible wordsmithing of API function descriptions including typo correction.

I referred to this discussion as I didn't want to quote you as I am unsure of the etiquette on the Drupal ecosystem surrounding such quoting.

Charles Belov
Webmaster
San Francisco Municipal Transportation Agency (SFMTA)

Contrib Development Best Practices

Group organizers

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds: