where is the migration document for sdk 14.1

[Thomas]

as I've been looking everywhere on the infocenter for a migration document from sdk 14.0 to 14.1 I was thinking that not finding it meant no changes needed. Of course that was wrong.

• There is already at least 1 thread about that problem(devzone.nordicsemi.com/.../)

I just found out the segger RTT code is not drop in compatible in 14.1: the file name RTT_Syscalls_GCC.c became SEGGER_RTT_Syscalls_GCC.c

I had to find out why things didn't work and then investigate to finally find that. Am I missing something and couldn't find the migration doc?

[Sigurd]

Hi,

There is only SDK migration guide on major versions (12 -> 13 -> 14). There should not be any significant API changes and incompatible issues going from a minior version 14.0 -> 14.1.

[Thomas]

If one goes from one SDK version to the very next one, not changing anything else, and the code does not compile, then you NEED to produce a migration document.

It is Nordic's responsibility as an API provider to give a list of things that Nordic knows will have to be changed. The question is not if changes are minor or not, the question is, if something changes and it breaks earlier systems, then you ought to document it.

This is extremely poor practice and will lead to numerous problems, cost and overage.

Feel free to provide this comment to whoever is in charge of deciding whether or not a migration document should be made. this situation should be addressed.

[Sigurd]

I'm sorry for the inconvenience. I will forward your suggestion on adding migration guides on minor versions too.

[Thomas]

thanks Sigurd, I know you are only the messenger here.

[Thomas]

as Sigurd mentioned, we can only suggest a change in the process of releasing new SDKs, the request being:

if code breaks after upgrade, make a migration document for API users.