I have an array that holds valuable data related to what I stored in a setup / onboarding process:
$imported_headers = [ 'headers_2', 'headers_3' ];
Given the fact that these elements are from the same category but their [each element's] content varies by a lot at times and each of them only holds references that allow me to go deeper in the history chain for other processes, what best should I call these 2 items?
Twins doesn't work - they're not the same nor do I want people who use my function to retrieve them to think of them this way; Sisters - same, don't want to denote any kind of intended similiarity of the said components structure / values.
$imported_headers will sometimes have upwards of 10 items in it, but this function will precisely only retrieve the latest 2, neighbors would have a kind of finality - supposedly there's no more neighbors if my function is called and it retrieves only these 2 values.
My reasoning for asking a seemingly useless question, besides tormenting SE's purists, is that this function is part of 10+ functions that tie my system together and it'll be widely used both by my system and anyone that wants to use my API, it has to be descriptive and clear. Currently my function name is
getSisterComponents. It matters a lot that I can have a conversation-like technical explanation about my code with other developers where I don't have to explain each function even if the said developer might not be aware of its implementation.
An example of exactly how my system works:
If I call
myPerfectFunctionName( 'headers' ); it should return the following array:
['demo-3_headers', 'demo-5_headers'], as such, anyone that sees / uses this function will understand immediately that I'm querying the back-end system to look for the installed components from a category and pull the latest 2 installed items from the said category.
I want it to express that the function is a main, important query and that these 2 values are vital to whatever the process that's using the function to retrieve them does. Simply naming it 'getLastTwoInstalledComponentsByCategory` doesn't express usage and is generic.