aiida-tutorials icon indicating copy to clipboard operation
aiida-tutorials copied to clipboard

👌 IMPROVE: Summarize key learnings before/after each chapter

Open ltalirz opened this issue 5 years ago • 1 comments

This is a suggestion from @mpougin

I would have found it helpful to provide a quick summary of the key points at the end. Of course it's best to learn the function of the commands in the context but when you want to apply it it's difficult to search for it. Like they do in the sw carpentry tutorials (e.g. https://swcarpentry.github.io/python-novice-inflammation/08-func/index.html). Then you know immediately if the chapter will help with your problem

I think this is a great suggestion.

ltalirz avatar Oct 23 '20 10:10 ltalirz

Yep I'm definitely +1 for this suggestion. It is the same thing I advocated for with the aiida-core tutorials/how-tos. I'm reminded of IMO a good approach to presentations:

  • Summarise what you are going to tell them = Tell them it
  • Summarise what you have told them

chrisjsewell avatar Oct 23 '20 11:10 chrisjsewell