alan-turing-institute / TuringDataStories

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

Open kevinxufs opened 2 years ago

kevinxufs commented 2 years ago

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

crangelsmith commented 2 years ago

Hi @kevinxufs!

@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?