add documentation for legacy, upgrade topics