Unfortunately the documentation is partly outdated. The reason is that it’s made by volunteers in their free time, just like the program itself, and the program has been more important than the documentation. You can find up-to-date articles in the FAQ especially sections Library, Footprints and Symbols.