This page will walk you through the process of preparing and submitting your idea. If you haven’t done so already, please review our call for contributions before continuing.
Site functionality and ethos
Our site is built on Quarto, the new open-source publishing system developed by Posit. The site has been designed from the ground up as a platform for data scientists, created by data scientists. Here’s what this means in practice:
Contributors can use data science software and tools to create content – e.g. Visual Studio Code, RStudio, Jupyter Lab; Python, R, Observable, and Shiny – allowing for the full integration of text, code, figures, equations, and other elements.
Review and editing are transparent and collaborative, again making use of tools data scientists are familiar with – e.g. GitHub, Google Docs – for sharing and revising documents prior to publication.
Content can be both engaging and interactive. Many data scientists learn by doing, so code can be made available as R Markdown or Jupyter Notebook files to be reused and experimented with offline. Or, the same documents can be used online through tools like Google Colab and Binder. Where appropriate, the use of interactive displays and Shiny apps is encouraged, allowing for data visualisations to be interrogated and regenerated on the fly.
Site users are contributors too. Through annotation and commenting functionality, site users can interact and converse with authors and other members of the community. And with all source files hosted on GitHub, users of our site can raise issues, or fork and propose improvements – leading to a true exchange of knowledge.
The submission process
Contact Pantelis Monogioudis via Linkedin to discuss your proposed submission.
Write up a short content brief containing the following:
- Title of submission
- Author name(s) and affiliation(s)
- Theme/topic area
- Target audience
- Synopsis or sell line, summarising the story and its importance/value (250 words max.)
- Key audience takeaways
- Formats and features (e.g., text, audio, video; code blocks, interactive data visualisations, etc.)
- Accessibility considerations
- Target length/word count
- First draft to be submitted by…
The RWDS_post_template repository on GitHub contains a Quarto document (content-brief.qmd) that can be used to produce your content brief.
Once a content brief is finalised and approved, content is to be prepared in the agreed format and with reference to our style guide. We recommend the Quarto (.qmd) file format. Use the RWDS_post_template repository to create your draft article in Quarto using the correct style and formatting. Documents can also be submitted in Jupyter notebook (.ipynb) format.
Draft submissions should be sent via email to the editor. Alternatively, contributors can commit their drafts to their own GitHub accounts using the RWDS_post_template repository and add site editor Brian Tarran as a collaborator.
Copyright and content licencing
Contributors retain copyright of their work, but agree to publish their work under a Creative Commons licence. Contributors are free to choose the licence that best suits their content. The chosen licence should be indicated on the draft submission.
The review process
Draft submissions will be shared for review with members of the Editorial Board. Comments and edits to documents will be made via Google Docs/MS Word/GitHub, allowing for (a) version control, (b) open dialogue between reviewers and contributors, and (c) a transparent and well-documented review process.
Once revisions are complete and content is accepted for publication, authors will be provided with HTML files to preview published content. Following sign-off by author and editor, HTML files will be made live.
Post-publication
Contributors and editors will work together to promote content via social media platforms – Twitter/X, LinkedIn, blogs – and in other channels as appropriate – e.g., in response to related questions on Quora or Stack Overflow.