Twarc Tutorial

[SamHames]

I think this is most of flow and content that I think should be included.

Outstanding items are (at least!):

• Make the research question/approach more concrete
• Write what is an API section
• Write introduction the Twitter API section
• Is the pandas section a good idea, and if it is, should we run it interactively or as a script. Obviously this should link to other lessons focusing on jupyter notebooks and other interactive analysis, but I'd prefer to avoid that in this base lesson.
• Link to more resources - what would be good?
• Does this all make sense?
• Make screenshots in windows of all the parts that need screenshots
• Spelling, grammar, and editing pass

[edsu]

This is looking good!

[boyd-nguyen]

Hi Sam, thanks for sharing the tutorial. I think it covers everything with enough details and explanations! Personally, one thing I would suggest is the order of some sections, outlined below:

• Motivating example (kept as is)
• Introduction to twarc and Twitter API
  • Introduction to twarc (moved from below)
  • Twitter API (brief explanation of what an API is, what "endpoint" means + what can you do with the Twitter API)
• Ethical considerations when using social media data
  • Ethical use of public communication data
  • Copyright
  • Twitter's term of service
• Setup (kept as is with the exception of Introduction to twarc which is moved up to the section above)
• "Introduction to Twitter search and counts" and other sections are kept as is

My rationale behind this structure is that it separates dev-related and ethics-related subjects into 2 sections. The Intro to twarc and Twitter API also provides the background knowledge needed to understand the content below, so that everything from Setup onwards will focus on using the tool. What are your thoughts?

There are minor letter-casing and editorial points that I came across, but I think it makes sense to leave them til the end once the high-level structure and everything else has been finalised?

[SamHames]

I've incorporated those suggestions, thanks!

[betsybookwyrm]

I've added a brief what-is-an-API section, but I struggled finding a good resource to link to for the target audience - researchers who want to understand what's going on but most likely don't need to do any coding. If anyone has a good link up their sleeve please share!

[betsybookwyrm]

I think the main things that are left to do are:

• take and put in the screenshots Sam has described
• proofread and get at least a semi-outsider to read through and see if it seems to make sense

[betsybookwyrm]

Thanks @boyd-nguyen and @mctakahashi for the screenshots, and Sam for merging :)

[Quiet27]

Awesome, hurray for the twarc tutorial! I did a content/proof-read review 😸

[igorbrigadir]

Awesome! This looks pretty good to me!

[betsybookwyrm]

We're all happy with this as a first pass! Thanks for having a look Igor. @SamHames did you want to have a final check?