Question: Do we need to mentioned differences with AMv2/v3 inside the API? Or in seperate sections?

In a lot of places, there are references to the Geni AMv2 API.

Do we need to keep these inside the API itself?
Perhaps they are better placed in a separate section at the end, which explains the differences? 
Such a section has already been added for the differences with the Geni AMv3 API (note that that section is still empty currently, it needs to be updated).