Documenting Software Architecture: Documenting Interfaces
Felix Bachmann, Len Bass, Paul Clements, David Garlan, James Ivers · 2002
This is the fourth in a series of Software Engineering Institute reports on documenting software architectures. This report details guidance for documenting the interfaces to software elements. It prescribes a standard organization (template) for recording semantic as well as syntactic information about an interface. Stakeholders of interface documentation are enumerated, available notations for specifying interfaces are described, and three examples are provided.