Update the architecture description

[Finishes #64123938]
better comment for semantic versioning hack