Migration guide to v8

[IvanRF]

There are many changes that are straightforward and easy to find in the new code. However, it took me some time to find old constants that now have new names.

It would be nice to start a Migration guide in the docs with some general changes or tips. For example:

Before 8.0	Starting with 8.0
SubstanceLookAndFeel.FLAT_PROPERTY	SubstanceSynapse.FLAT_LOOK
comp.putClientProperty(SubstanceLookAndFeel.FLAT_PROPERTY, Boolean.TRUE)	SubstanceCortex.ComponentOrParentScope.setFlatBackground(comp, true)
SubstanceLookAndFeel.WINDOW_MODIFIED	SubstanceSynapse.CONTENTS_MODIFIED
getRootPane().putClientProperty(SubstanceLookAndFeel.WINDOW_MODIFIED, modified)	SubstanceCortex.RootPaneScope.setContentsModified(getRootPane(), modified)
LafWidget.TEXT_EDIT_CONTEXT_MENU	SubstanceSynapse.TEXT_EDIT_CONTEXT_MENU
JComponent.putClientProperty(LafWidget.TEXT_EDIT_CONTEXT_MENU, Boolean.TRUE)	SubstanceCortex.GlobalScope.setTextEditContextMenuPresence(true)
SubstanceLookAndFeel.setDecorationType(panel, DecorationAreaType.GENERAL)	SubstanceCortex.ComponentOrParentChainScope.setDecorationType.setDecorationType(panel, DecorationAreaType.GENERAL)
UIManager.put(SubstanceLookAndFeel.SHOW_EXTRA_WIDGETS, Boolean.TRUE)	SubstanceCortex.GlobalScope.setExtraWidgetsPresence(true)
SubstanceLookAndFeel functions like setSkin, getCurrentSkin, registerSkinChangeListener, setFontPolicy, etc.	All these functions are in SubstanceCortex.GlobalScope class

[kirill-grouchnikov]

DecorationPainterUtils is an internal class.

SubstanceCortex is the main entry point to customize Substance behavior, along with additional APIs in org.pushingpixels.substance.api and its subpackages.

At the present moment the consolidation of older APIs under the SubstanceCortex roof is the new world, and a complete migration guide beyond this will not happen.

[IvanRF]

DecorationPainterUtils is an internal class.

Sorry, I just saw the correct function: SubstanceCortex.ComponentOrParentChainScope.setDecorationType.

At the present moment the consolidation of older APIs under the SubstanceCortex roof is the new world

OK, I like that, now that I think about it everything I used is in that class, it will make the transition easier.