-
Notifications
You must be signed in to change notification settings - Fork 663
GSoD FAQ
Frequently Asked Questions for Google Season of Docs with MDAnalysis.
Please read
We grouped questions and answers in broad categories:
If you have questions that are not answered here contact us on the developer mailing list and ask. We are happy to answer your questions.
All communication regarding GSoD is carried out publicly on the developer mailing list https://groups.google.com/forum/#!forum/mdnalysis-devel. The email address is [email protected].
Note
- Initial emails are screened by moderators so first posting will only happen after a delay of a few hours.
- All replies go to the mailing list and not your private email address.
- Read the email replies through the public web interface https://groups.google.com/forum/#!forum/mdnalysis-devel or subscribe to mdnalysis-devel to get the emails.
All replies go to the developer mailing list and not your private email address.
Read the email replies through the public web interface https://groups.google.com/forum/#!forum/mdnalysis-devel or subscribe to mdnalysis-devel to get the emails.
Yes, please!
- When you introduce yourself, tell us how you successfully communicated technical ideas.
- Provide links to your work and add context – tell us, what you've done in the specific linked work and what you are particularly proud of or what you think worked well.
- Tell us about your technical experience (e.g., use of molecular dynamics simulations, use of MDAnalysis or other related software).
Projects are listed in the Project Ideas List together with approximate estimates of effort.
Yes, we envisaged that technical writers would do one of the shorter projects as a "starter project" and one of the longer ones for the remainder of the time. Ultimately you will have to write a proposal that shows convincingly how you will accomplish the work that you proposed.
Become familiar with MDAnalysis: What is it used for, how is it used.
Are you familiar with computer simulations of atoms and molecules? If not, learn a little bit about "molecular dynamics simulations". You can also watch the SciPy 2016 talk on MDAnalysis.
Work through the MDAnalysis Tutorial and get a feel for how MDAnalysis is used (and take notes of things you would improve – we know that our docs need improving, hence GSoD!)
We understand that making you use our software is a sizable initial ask but on the other hand, MDAnalysis is relatively complicated software that is used in research by many people and we doubt anyone could write documentation for it without actually trying to use it. We are happy to help answer questions as you go along. We are also happy to work with you on refining your project ideas, based on your experience.