Thank you for taking a look at this!
So, the tl;dr is that you would need to add detail to an item when you basically have to build and communicate a concept in your mod structure for the player to successfully engage with it.
In this case, I have a system wherein I add several metals, each of which have properties, and the player machines those into various Stocks -- sheet stock, angle stock, etc. Those cannot, by themselves, be used for anything -- EXCEPT to be made into machined parts that retrain one or two properties. That is, there's an interface:
[Metal-Stock] -> [Property-Machined Part]
This is my solution to Factorio not having fungible reagents; basically, it allows me to source, say, "Load Bearing Framing" from Iron, Titanium, and Steel. Same with "Corrosion-Resistant Piping" and "Basic Shielding" and such. Then, I can make a single recipe for, say, an Assembling Machine 1 -- instead of a myriad of recipes that all account for the different metals.
And I have to explain this to the player. The thing is, there's a number of metals, stocks, properties, machined parts, and metal machining entities (minisemblers in my case) that all interact with one another, and this can get very confusing. To combat this, I made very expansive tooltips that outlined what the player would need to know at a glance in order to utilize something. Metal-Stocks list their properties and what minisemblers consume them; Property'd-Machined-Parts list what metals can source them and what stocks are needed for this.
This information would be very useful to have in tooltips, because it'll help keep players in flow as they learn to navigate the structure of the production chains. On the other hand, expert users may not want the clutter. So I've made a setting in my mod that will activate or deactivate the Detailed Tooltips. But, in both cases, the Factoriopedia entry should reflect the information contained in the Detailed Tooltips. Hence, the request. I've shared two screenshots of tooltips that utilize this approach.
There are also a bunch of recipes that should be able to take advantage of this as well -- I have downgrade recipes, remelting recipes, machining byproducts, and various other groups of recipes that relate to other concepts in the modpack. These would benefit from explanation in the Factoriopedia.
I hope this helps! <3

- 03-10-2025, 07-10-57.png (456.95 KiB) Viewed 574 times

- 03-10-2025, 07-11-17.png (440.56 KiB) Viewed 574 times