expose and use serialise(for_db)
docs
Merge branch 'master' into serialize_for_db
changelog + version bump