TuringDataStories: An open community creating “Data Stories”: A mix of open data, code, narrative 💬, visuals 📊📈 and knowledge 🧠 to help understand the world around us.
Other
39
stars
12
forks
source link
Support for readers without any coding / data expertise. #181
I recently shared some of our stories with my non technical colleagues who have no background in coding or data. They found it interesting to read the Fast Pages, but they struggled take on board any of the pedagogical aspects of the stories. It can be frustrating coming to an educational piece but still not be able to engage with it.
I suggest we could have some kind of 'beginners guide'.
I think we recognise that our stories are perhaps not targeted at the complete beginner (for example, we don't explain 'obvious' code like what it means to import libraries or what it means to use a for loop). I don't think we need to change this, but I do think there could potentially be a bit more help for complete beginners.
What needs to be done?
A beginner's guide could be fairly simple and could potentially include it as a page on our Fast Pages.
I'm thinking it could cover:
links to a Python tutorial
links to explain what a jupyter notebook is and how one can run it
an reaffirmation that we would encourage people to test out our notebooks (not just the fast page) and experiment with them.
Maybe even some exercises for each story on how they might be played around with.
Who can help?
I'm happy to try out some basic text here, I might need some help getting the FastPages connection though.
@radka-j and I have some time this summer to work on improving the documentation and update the fast pages with this. Have you had a chance to sketch some of this text on this?
Summary
I recently shared some of our stories with my non technical colleagues who have no background in coding or data. They found it interesting to read the Fast Pages, but they struggled take on board any of the pedagogical aspects of the stories. It can be frustrating coming to an educational piece but still not be able to engage with it.
I suggest we could have some kind of 'beginners guide'.
I think we recognise that our stories are perhaps not targeted at the complete beginner (for example, we don't explain 'obvious' code like what it means to import libraries or what it means to use a for loop). I don't think we need to change this, but I do think there could potentially be a bit more help for complete beginners.
What needs to be done?
A beginner's guide could be fairly simple and could potentially include it as a page on our Fast Pages. I'm thinking it could cover:
Who can help?
I'm happy to try out some basic text here, I might need some help getting the FastPages connection though.
Updates