clayton-aldern / rji-dug Goto Github PK

Some notes, links that IDK how to HTML that you're more than welcome to incorporate:

• https://jamstack.org/why-jamstack
  • https://github.com/automata/awesome-jamstack#static-site-generators
    • Hugo
      • fast, markdown
      • short codes for embeds are cool
      • there are AMP templates (speed wins)
      • hugo-academic for portfolio, CV
        • search-friendly structured data (Linked Data) in templates
        • https://themes.gohugo.io/academic/
    • Jupyter-book can generate HTML, LaTeX, PDF from MyST Markdown and Jupyter Notebooks (with Sphinx, which is what e.g. the Python and Linux kernel docs are built with)
      • https://github.com/executablebooks/jupyter-book

      • Notebooks enable Evidence-based Policy, Data Driven Journalism, Peer Review

      • Cool visualizations (like NYTines' d3.js) are easy to prototype in Notebooks (there's an IJavascript Jupyter kernel) even if you're not able to publish read-only notebooks with your publishing platform yet.
        • https://github.com/dexplo/jupyter_to_medium

I'll just CC this:
https://news.ycombinator.com/item?id=20173228
https://westurner.github.io/hnlog/#comment-20173228 :

---

It's more work to verify all formulas that reference unnamed variables in a spreadsheet than to review the code inputs and outputs in a notebook.

"Teaching Pandas and Jupyter to Northwestern journalism students" [in DC] https://www.californiacivicdata.org/2017/06/07/dc-python-notebook/

http://www.firstpythonnotebook.org/

You can also develop d3.js visualizations — just like NYT — with jupyter notebooks and whichever language(s).

"Data-Driven Journalism" ("ddj") https://en.wikipedia.org/wiki/Data-driven_journalism

http://datadrivenjournalism.net/

"The Data Journalism Handbook 1" https://datajournalism.com/read/handbook/one

"The Data Journalism Handbook 2" https://datajournalism.com/read/handbook/two

While there are a number of ScholarlyArticle journals that can publish notebooks, I'm not aware of any newspapers that are prepared to publish notebooks as NewsArticles. It's pretty easy to jupyter convert --to html and --to markdown or just 'Save as'

Regarding expressing facts as verifiable claims with structured data in HTML and/or blockchains: "Fact Checks" https://news.ycombinator.com/item?id=15529140

Does this course recommend linking to every source dataset and/or including full citations (with DOI) in the article? Does this course recommend getting a free DOI for the published revision of an e.g. GitHub project repository (containing data, and notebooks and/or the article text) with Zenodo?

---

https://data.berkeley.edu/academics/resources/textbooks :

Berkeley's core data science classes all offer its students free access to an interactive online textbook. The books are created using a service from Project Jupyter in collaboration with the Berkeley Data Science Education Program (DSEP) known as a Jupyter Book. The most updated textbooks for these core classes are listed below.
[CC-BY-NC-ND-4.0]

---

Notebooks enable Evidence-based Policy, Data Driven Journalism, Peer Review

Reproducible, executable analyses prepared by data scientists trained to communicate that we can run again with different and the latest data - that cite URLs or DOIs - are ideal for Evidence-based Policy and the Data Driven Journalism that must role model hypothesis formation and testing if we are to validatedly progress.