Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
assignee='https://github.com/bitdancer'closed_at=<Date2016-09-08.16:50:56.168>created_at=<Date2015-05-24.14:10:33.319>labels= ['type-feature', 'expert-email', 'docs']
title='Take the new email package features out of provisional status'updated_at=<Date2016-09-08.16:50:56.167>user='https://github.com/bitdancer'
I plan to remove the provisional status of the new email features in 3.5. This is a documentation only change, but the documentation change is extensive (pretty much a complete rewrite of the package docs).
Obviously I quite missed the 3.5 deadline, and it is only thanks to the Core Sprint that I'm going to make the 3.6 deadline, but at least I'm making it.
There is one code change in this patch, changing the default behavior of as_string/str on EmailMessage (only) to be more sensible, and take advantage of the policy.utf8 flag to make str output more readable by default. Otherwise, it is simply (hah) a fairly complete documentation reorganization and rewrite giving primacy to the new API and demoting the old API to 'legacy'.