-
Notifications
You must be signed in to change notification settings - Fork 41
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Draft blog post for version 0.16.2 #58
Conversation
_posts/2017-12-31-release-0.16.2.md
Outdated
|
||
Just a few weeks after our last release, we are releasing MDAnalysis version | ||
0.16.2. The [release notes][notes] list the full details of the changes in this | ||
version. Like the previous one, this release is dedicated to fixing bugs. It |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I wouldn't say it's dedicated to bug fixes, the point of it is the deprecations and we need to be loud about this
_posts/2017-12-31-release-0.16.2.md
Outdated
[`MDAnalysis.analysis.base.analysis_class`][analysis_class] function can be | ||
used to replace the deprecated `Timeseries`. | ||
|
||
Quick selectors are also deprecated and will be removed in version 1.0. You can |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Probably best to give examples of what these are and how to replace them
_posts/2017-12-31-release-0.16.2.md
Outdated
Finally, the global [flags][] will disappear in version 1.0 to be replaced with | ||
more granular keyword arguments in the appropriate methods. | ||
|
||
Removing outdated code allows us to keep MDAnalysis robust and consistent. We |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
.. as we prepare for 1.0 where features will become frozen
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The interface is going to be frozen. We will hopefully add features.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for starting this @jbarnoud , I've added some comments, but I might have time to get to them myself later
I addressed a couple of comments. But what level of details should there be for the quick selector? We do not want to induce the use of them accidentally by advertising them to much in the blog post that explains there are going to disappear 😛 |
Ha, I guess, it's just not immediately obvious what is meant by 'quick selectors'. You could use that feature but not know what we call it. |
_posts/2017-12-31-release-0.16.2.md
Outdated
The first feature to be deprecated is the [`Timeseries` module][timeseries] | ||
that will be removed in version 0.17.0. The | ||
[`MDAnalysis.analysis.base.analysis_class`][analysis_class] function can be | ||
used to replace the deprecated `Timeseries`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
a link to the old 0.16.0 blog posts showing the class would be good here.
_posts/2017-12-31-release-0.16.2.md
Outdated
read the discussion in [issue 1377][issue_1377] to learn how to replace the | ||
different selectors. | ||
|
||
Finally, the global [flags][] will disappear in version 1.0 to be replaced with |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add new links and describe what quick selectors are.
….io into blog-0.16.2
- link to *instant selectors* (not "quick selectors"); for all the other deprecated features we link to docs so we should also do this for instant selectors - added a bit more justification for deprecation of instant selectors and flags - use http://doc.mdanalysis.org for links to docs - grammar fixes
I edited the blog post through GH, please have a look, especially @richardjgowers given that you had already approved the prior version. |
The blog looks good to me |
No description provided.