The first post on this blog encouraged you to submit your own posts; but the advice was vague about what to submit or how. This post makes the advice concrete.
What to submit
Each published article needs only two things:
A title, e.g. “Publish your post here”.
A body, i.e. the contents of your post.
And it is nice to have a few optional things:
A description, e.g. “Details on what and how to submit a new blog post”.
A link to your website, e.g. https://github.com/maurolepore.
An image that is licensed to share publicly, e.g. from https://www.pexels.com/creative-commons-images/.
One or more categories to help readers filter similar posts, e.g. “meta”.
Most of this is just plain text, which is easy to submit for publication in a number of ways.
How to submit
The priority is to publish your content; how you do it is unimportant – you may submit it however you like. For example, here are some ways:
Slack: Send me or Jackson a file via Slack with your text or a link to it (e.g. a link to a Google Doc).
GitHub: On GitHub, create a new file and paste your text in it.
GitHub will automatically fork the blog’s repo into your user account and guide you to create a pull request.
- RStudio: Fork the blog’s repo; create a new RStudio project from your fork; create a new post with
distill::create_post(); commit your changes; push your commits to your fork; submit a pull request to the blog.
distill::create_post() gives you a template you can then modify. For consistency across posts, we recommend you change the template’s yaml header and setup chunk to follow this examples:
- YAML header
---
title: "Publish your post here"
description: |
Details on what and how to submit a new blog post
author:
- name: Mauro Lepore
url: https://github.com/maurolepore
date: 07-28-2020
output:
distill::distill_article:
toc: true
self_contained: true
categories:
- meta
- ds-incubator
preview: preview.jpg
twitter:
site: "@mauro_lepore"
creator: "@mauro_lepore"
---- Setup chunk
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>"
)–
As far as the world can tell, your work or ideas do not exist unless they are published somewhere. Get stuff out. The technical details don’t matter (we’ll help you with that); what matters is your idea – share it early, share it often.