Thank you for blazing that trail.

On Jan 24, 2020, at 11:14 AM, Kasper ��sterbye <kasper.osterbye@gmail.com> wrote:

 Cheers all,

There was a mail about Spec2 documentation on this list in the last few days. I had a Spec program, and wanted to see how to migrate it to Spec2. 
The before and after is the master and the Spec2Migration branches of: https://github.com/kasperosterbye/ovina

I decided to write down an account of all my struggles in making this migration. That account is on: https://github.com/kasperosterbye/ovina/blob/Spec2Migration/SpectoSpec2.md

Beware - it is LONG.

In the end, I draw the following conclusions:
  • Class comments on which classes to use instead of the depricated ones should be mandatory!
  • Spotter is a real help
  • Changing terminology is a true pest - in particular since the terminology of a library is used in the applications - in my case Tab became Page.
  • The new library has not yet implemented all parts of the old one (but I am sure it has implemented new stuff as well).
  • The SpDemo class is not only good, it is a template for others to follow.
  • Do not silently delete features. Be brave and include a method oddRowColor with a comment saying it is not going to be implemented in this version, and why.
Some of them refer to specifics of the code. 

Overall I can say, that earlier today, Estaban wrote:
"Widgets API is more or less compatible, chances are that your components will work out of the box or it will be rewritten by a deprecation rule.
What is not compatible and there I not auto migration is the layout. You will need to rewrite those.���

I am afraid to say, that was not my experience :-)

Best,

Kasper