Skip to content

Tessel's community blog. Team Members are welcome to submit posts as PRs here for editing.

Notifications You must be signed in to change notification settings

dbuentello/this-week-in-tessel

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tessel Blog

Code of Conduct

What content goes on the Tessel Blog?

Anything related to Tessel is fair game – philosophy on where IoT is going, hardware tutorials, self-introductions to the community, and more. If you're not sure, post an issue and ask if your idea is a good fit.

The Tessel Blog is not meant to be a place for content marketing.

Who can write for the Tessel Blog?

Anyone from the Tessel community is welcome to write for the Tessel Blog, subject to our usual contribution guidelines.

Community members are particularly encouraged to work on This Week in Tessel (TWIT), either by adding to an existing Issue or PR, or opening one. See below for how to write the TWIT.

Team Members should post their own content once it is merged. If the post is submitted by a non-Team Member, whoever merges the post should post it.

How to post

All Team Members should have access to the password for the Tessel tumblr via our password management system. (If you don't, request access from a Steering Committee member.)

On the Tessel blog (tumblr), sign in, create a new text post, and copy in the full post text in Markdown.

Add relevant tags, including update this week in tessel twit updates for TWIT posts.

Publish! Then to push live, follow Production Release instructions on the tessel.io repo.

Post the subject line and link to blog post from tessel.io/blog to Twitter, ideally also including an image (if not from the newsletter itself, then something from our Instagram.

It will automatically cross-post to our Facebook page.

Also post it in /r/Tessel.

How to write This Week in Tessel

(Our not-so-weekly update)

Collect material

  1. Create an issue to collect content. Example
  2. Figure out if there's any major update/call to action/etc. we need from the community and include as necessary.
  3. Collect blog post links, projects, etc. from the community. The easiest way to do this is to look at what we've tweeted/retweeted in the last week. Our Twitter profile
  4. Look at our latest hardware/software updates and note if there's anything particularly interesting or exciting.

Write the TWIT

Keep it short, and cut content liberally. You can find a template in TWIT-template.md.

Copy the template. Rename to include the date of intended publication in the filename as YYYY-MM-DD-TWIT.md. Fill it in, and create a pull request mentioning a fix to the collector issue. Then, the #reviews channel on Slack is a good place to seek feedback.

Send the email

Create the campaign using the This Week in Tessel template.

Name the campaign something like "This Week in Tessel - Date"

Copy and paste the rendered markdown from any markdown renderer, instead of using Mailchimp's specialized formatting (because, what a pain otherwise). Mailchimp handles this pretty gracefully, but read it over anyway just in case.

Preview using Mailchimp's preview and test menu. Be sure to send at least one test email and read it over carefully.

Send! Ideally sometime in the morning on a weekday.

Also follow the blog-posting instructions.

About

Tessel's community blog. Team Members are welcome to submit posts as PRs here for editing.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published