• I have to split hairs just a little on this one. If the undocumented feature can be run stand-alone that is one thing. But if it is something that is always intended to be used by the product internally or only used in certain instances and certain ways, that is another.

    In the toolbox analogy if there are tools in the toolbox I agree the "users manual" should explain those tools. However if inside one of the electric tools in the toolbox there is a special mechanism that is unique to that tool and used only by that tool, it is undocumented and "under the hood". Just because someone could take that unit out of the electric tool and use it for something else does not mean that the maker of the toolbox is required to write documentation on it. The person taking the mechanism out of the electric tool assumes their own risk if they use the tool for what it is not intended to do.

    But again if the tool is exposed stand-alone undocumented that seems odd and should be addressed.

    Not all gray hairs are Dinosaurs!