Making my newsletter FAIR


I am in the process of making my newsletter FAIR (Findable, Accessible, Interoperable, and Reusable). Here's how.

I am an advocate for Open Science. The FAIR priciples are very near and dear to my heart.

I was excited when the Open Science folks at Jülich archived a bunch of my posts and gave them a persistent identifier (DOI, see archived posts here). This was exactly what I was still missing to make my posts more FAIR. However, I cannot expect them to take care of archiving all my posts and I would love to have all of them available with not only a DOI, but also in a more machine-readable way. That is why now I am finally getting to it and am making all future posts available, searchable, machine-readable, reusable with an open license (CC-BY 4.0) and with a persistent identifier (DOI).

I spent the whole day on this and here’s the plan that I came up with:

Infrastructure

This section is for the tech nerds here who want to know all the details. If you’re not one of them, that’s ok. You don’t need to know what Jekyll is 😉.

I am planning on using the following infrastructure setup:

  • Jekyll website (hosted via GitLab pages), that allows me to write Markdown posts and creates an Atom feed.
  • Kit newsletter service that can turn an Atom feed into newsletter posts automatically.
  • Add my blog to Rogue Scholar, an archive for scholarly blogs, which provides long-term archiving, DOIs and metadata.

I really like using Kit for my newsletter and love creating email courses and automations with it. To make my newsletter FAIR, however, it’s not quite suitable, because the only way I could archive it and generate a DOI would be manually. Knowing myself, I’d probably forget doing that.

So, I am switching to using two tools instead of one and I am getting even more exposure by publishing on Rogue Scholar. Isn’t that something? 🤓

My website is already set up. I am using Jekyll (Minimal Mistakes theme) and have a GitLab repository from where my website is automatically built (see pipelines). Adding a blog is incredibly easy, as Jekyll is meant for writing blogs and with the jekyll-feed plug-in an Atom feed is generated without me having to understand how it works (which is good, because I don’t).

Workflow

From now on I will do the following when I want to write a newsletter post:

  1. Write post in Markdown.
  2. Push post to GitLab repositor to build my website, which automatically generates the Atom feed.
  3. Adapt the automatically generated newsletter and send it to my subscribers.
  4. Check if the post shows up on Rogue Scholar (which it automatically should).

Does this make my newsletter FAIR?

Well, FAIR is not binary, but a spectrum…

I think having a unique and persistent identifier in the form of a DOI and improving long-term availability makes the newsletter more FAIR.

I am open for your suggestions on how I could make it even more FAIR in the future.

I am also open to hearing what your thoughts are about my new setup, even if I am a little scared 😬

I am ending the day quite pleased with myself and hope you enjoy reading my self-centered post of the day 🎉

All the best,
Heidi


P.S. If you're enjoying this newsletter, please consider supporting my work by leaving a tip.

Let's connect!

Mastodon | LinkedIn | Website

Digital Research Academy

Mastodon | LinkedIn | Website

Heidi Seibold, Bayerstr. 77C, Munich, 80335
Unsubscribe · Preferences · My newsletters are licensed under CC-BY 4.0

Dr. Heidi Seibold

All things open and reproducible data science.

Read more from Dr. Heidi Seibold
collaboration iceberg

Too many code projects in research are done by a single person. Keep reading on why that's bad and how to do better. It’s been a while since my last post. Founding the Digital Research Academy, holidays and LOTS AND LOTS of workshops and events have taken all my time. But it’s time to start writing again. One of the workshops I taught since my last post was on collaborative coding at the wonderful RSE summer school at KIT (click through the timetable to find all kinds of cool materials)....

Mel, Joyce, and Heidi at the notary

I am excited to share that the Digital Research Academy incorporation is almost done. We had our notary appointment last week, set up the bank account and are now waiting for the official registration of the DRA Digital Research Academy GmbH. I published my first post about the initial idea for the Digital Research Academy in May 2023. Now, just a year and a few months later, the Digital Research Academy is becoming not only an initiative but a company. Last week Joyce Kao, Melanie Imming and...

I get asked for career advice all the time (even though I am just figuring stuff out myself). Generally I try to help by listening and asking questions, but there is one thing that I tell everyone who wants to hear it: pick work where you like the people. How do you pick the research group you want to work with? My recommendation is to pick based on two things: Do you like the topics they work on? Do you get along with the people in the group (in particular your boss/supervisor)? The first is...