docs: document describing how to update symbols map files + bugfix in the symbols generator for major versioning

docs: document describing how to update symbols map files + bugfix in the symbols generator for major versioning #2134