The rOpenSci newsletter is a Jekyll site. Each newsletter entry is in
_posts/, with name pattern like
Note that we're constantly moving towards more automation; the below process will be updated as changes occur.
Steps for producing each newsletter entry:
- Copy last weeks post and change the date in the file name and yaml header for the current day.
- Keep headers for each section but delete last weeks content.
- "rOpenSci HQ" section: hand curated. "big" things to announce: community calls, new hires, new grants, etc.
- "Software" section
make pkg_versions_prepto prepare data for new packages and new package versions. Once that's done it updates the files in
data/newversions.csv. b. Run
make pkg_newsto prepare actual text for package news section. The output is put in the console - copy/paste that to the appropriate section in the newsletter. A few edits may have to be made, and if there's no entry for the package in question in
data/pkg_metadata.csvan entry will have to be made.
- "Software Review" section: Scan through https://github.com/ropensci/software-review/issues/ and list any new submissions and any newly approved packages. See previous posts for how to format these.
- "On the blog" section: Scan through https://ropensci.org/blog/ and https://ropensci.org/technotes/ and list any new blog posts, with author and a short description of what the post was about. Include an image if there's an obvious image to include. See previous posts for how to format these.
- "Use Cases" section: gather new citations from https://github.com/ropenscilabs/ropensci_citations repo, put them in
data/citations-to-use.txt(making sure to use tab-indentation, then run
make citations_prep, which spits out a bulleted list of citations
- "From the Forum" section: optional section to include with any links to interesting blog posts. I subscribe to a number of newsletter for different programming languages, and get ideas from those.
- "Call For Maintainers" section: mostly stays the same; updated if any new packages that need maintainers
- "Get involved with rOpenSci" section: stays the same, leave as is
- "Keep up with rOpenSci" section: stays the same, leave as is
- Before posting the newsletter, run
make checkto check the URLs. the command automatically checks the most recent post that you just created to make sure the urls are okay in the post
makefile has the following make commands:
- check - citations_count - citations_prep - pkg_versions_prep - pkg_news - pkg_narrative - checklist
rOpenSci News Checklist ❯ rOpenSci HQ Any rOpenSci announcements? Check for issues at https://github.com/ropensci/biweekly/issues ❯ Packages: new packages: ⓧ new versions: 12 ❯ Software review (new submissions/approved) Check https://github.com/ropensci/software-review/issues manually ❯ On the blog (new posts): 3 post title: 2 Months in 2 Minutes - rOpenSci News, August 2020 post title: Developing dittodb post title: Scientific Name Parsing: rgnparser and namext ❯ Citations (new schol articles) 22 citations in the last newsletter; use citations after: Davis, Z. (2020). Leaf the kids outdoors: approaches and enquiries in quantifyin ... ❯ From the forum (new topics): 1 topic: Bar chart portraits ❯ Call for maintainers Any packages need a new maintainer? If so, add them to the list in this section ❯ In the news Any must read (non-rOpensci) blog posts we should tell readers about?