-
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.
No, you don't have to pick from the list. We are open to your own project proposal.
We suggest that you discuss your idea with us so that we can give you more insight into where your idea would fit into the broader requirements of the MDAnalysis project. You can also start with our project ideas and modify. In any case, we're happy to refine your idea together with you.
No, we don't think that this project on its own is sufficient for a whole GSoD. We estimated its effort to be about 25% of the total time.
If you think you can substantially broaden it then you might be able to make a full proposal work. Ultimately, your proposal has to convince us that you are (1) doing work that will substantially improve the user's experience with MDAnalysis, (2) is feasible, and (3) makes good use of the provided resources provided by GSoD.
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.