new sdk migration guidelines

[vit bernatik]

Hello, I'm trying to upgrade my SDK v11 project to SDK v12 project and I just got sober from idea that I switch SD and update "components" folder.

For example I was using for debugging macro NRF_LOG_PRINTF in SDK v11. This macro is not present in SDK v12.

Would it be possible to release with each new SDK some guidelines how to migrate? It can be simple list of functions that have been updated/removed with link to new function that shall be used instead.

Also it might be helpful to change API in 2 steps. First you would mark the function in new SDK as obsolete. And only in next SDK you remove it. So we will have some time to update codes using your API.

[gortok]

Even a formatted diff between old header files and older defines to new header files and new defines would be preferable to what we have now. You can generate said diff with git and a shell (or batch) script.