/100daysofDX

One DX related post every day for 100 days

Primary LanguageHTMLOtherNOASSERTION

Website for DX

100 Days DX blog cover

The site is a collection of developer experience posts - short posts. It is hosted as gh-pages and served via 100daysdx.com. The site might stay alive after 100 posts have been reached. If it proves to be valuable - I'll find a way to keep it alive.

Suggest topics

You can suggest topics for me by raising an issue. I will not promise to write about your suggestion, but I promise to consider it thoroughly.

New idea for a post - raise an issue!

Support via Patreon

This is a freetime project and I spend significant amount of my time in it. If you see value in the site, you can support the effort via Patreon.

Contribute a post

To contribute a post, do the following:

Create issue

  • Add issue to issue list with label "Topic-idea"
  • Wait until it has been approved (label "Approved" appears to it). In the comment you'll get the day number. The day number indicates when it will be published. You'll need the number in branching. See below.

Work on the content in branch

  • Clone the repository
  • Make a branch and follow naming pattern "feature/dayX" in which the "X" is the number of the post given to you in idea approval. See above.
  • Add your post to "_posts" folder and follow the naming pattern yyyy-mm-dd-X.md, in which the "X" is the number of the post given to you in idea approval.
  • Take a screenshot of the post header containing the header and description text, not the date. Make the picture 600px wide. Name that image as "blog.png". Make sure the frontmatter image field points to right folder image: "/assets/img/dayX/blog.png"

Example frontmatter:

---
layout: post
comments: true
title: "#6 - Show the result I can create with your API as a selling argument"
date: 2019-07-19 03:32:44
image: '/assets/img/day6/blog.png'
audio: "https://s3.us-east-2.amazonaws.com/100daysdx/9c27622d-ed5c-4b30-835c-7e479ac37076.mp3"
description: "I am not going to buy your API product unless I can try it and see the results if they have any value."
tags:
- DX 
- 100DaysDX
- value proposition
- text-to-speech
- amazon
- google
- freemium
categories:
- DX
- 100DaysDX
twitter_text: "I'm not going to buy your API product unless I can try it and see the results if they have any value."
---
  • Autogenerate mp3 from the content if you can. I use Polly from Amazon for it. Don't worry if you don't have the time for it. It can be added later too. In that case, just remove the audio: line.
  • Pictures of the post are all added to /assest/img/ folder in which you should create a folder "dayX" in which the "X" is the number of the post given to you in idea approval. Just look at the previous posts and follow the lead.
  • Since most of the posts are written by Jarkko Moilanen, but you should get the credit for it, you can add your details (name etc) in the beginning or the end. That way all know you've written it!

Make a pull request

  • When you are done with the post, add "Ready" label to your issue. Then make a pull request.