Open kneekoo opened 1 year ago
That's what the [footgun] tag in the issue tracker here would be for.
I'm not sure where we should have a document of "just footguns". The original idea was to just use the appropriate DANGER / WARNING admonitions for docs documenting the relevant features.
The documentation will likely always lag behind the latest version of the engine, and not everything is thoroughly documented in the first place. But considering that games and mods have various issues related to improper API usage, impacting both players and contributors, a guide covering the most common pitfalls would be very useful.
So instead of sharing empty criticism about how some games and mods are "broken beyond repair", a guide to addressing common issues is the mature thing to do. This helps the entire ecosystem.