Documentation is made of many parts. The first obvious piece of documentation that most developers for BeOS have become familiar with is the BeBook. Aside from that, there is also the common method of looking at the supplied headers. When looking at code itself, documentation is generally considered to be comments. However, another important part of code documentation is names.
In header files these names figure most prominently in three places. First, the class names. Second, the method names. Third, the argument names.
Of these, only the last can be changed without affecting past code. Of course, this doesn't mean that we shouldn't change or supplement the others if it doesn't serve a good purpose. (this is the principle of GE after all)
One type of error which we can help to avert by changing the argument names are DeallocationRightsErrors.
