Details on what and how to submit a new blog post
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.
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.
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.
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:
--- 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" ---
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.