silverstripe / silverstripe-userhelp-content

User-level docs for the Silverstripe Framework and CMS
Other
1 stars 58 forks source link

Version differences message #167

Open clarkepaul opened 3 years ago

clarkepaul commented 3 years ago

It would be good if we outlined how user help approaches the differences in experiences from version to version at the beginning of User Help.

Just a rough example... “These guides have been written with the latest release in mind, older version may find differences to the experience outlined here. Please be aware that every installation has likely been customised so differences are likely to occur. If you find the guides do not align to what you with what you expect the core CMS experience to be, then please submit an issue so we can update it accordingly.”

This means we don't have have to reference versions for each different experience released, but rather just keep it aligned with the latest release. It also means we don't have to cater to explaining multiple experiences or go back and clean out old version numbers which are just clogging up the guides. This should keep the guides a bit cleaner and more future proof.