The Octopus blog is one of the ways we talk to our customers and help future customers discover Octopus. We do this by publishing posts that resonate with our users (and potential users) on topics of interest to them that demonstrate our domain expertise.
This repository contains the Octopus.com/blog posts.
Authors must sign the Contribution License Agreement (CLA) before we can accept your contribution.
The repo includes templates to help you get started.
If you're drafting a post that you'd like to keep private until it's ready for review, use the internal blog drafts repo. Transfer it to the public repo when it's ready for review.
See the Octopus style guide for the following information:
- The Octopus voice and style
- Writing educational content
- Writing tips for the blog
- Markdown quick reference
Please note the advice about adding resources to your post.
You'll also find some helpful links and information on the PR template.
For specific instructions, please see the section on creating a new branch, pull request, and blog post in Confluence.
Internal authors can create a branch for their work, external authors need to fork the repo.
Posts are organized in year-month directories (i.e., 2023-01/). Find or create the directory that is roughly when your post is going out and add your files there.
If you'd like feedback on a work in progress, create a draft PR and tag @TeganAli with your request, however she'll do a full review and edit when the post is submitted as a PR and she's assigned as a reviewer.
When you're happy with your post and it's ready to be reviewed, please create a PR. Go through the checklist on the PR template, assign @TeganAli as reviewer, and drop a note in Slack in #topic-content-marketing. (No need to fill out a content brief.)
When submitting your post in #topic-content-marketing, you also need to provide copy for a Twitter post and LinkedIn post to promote your blog post in #topic-social-media. (The marketing team will edit and post these on social media.)
- Please make sure your tweet is no more than 280 characters, including spaces and the link to the blog post.
- LinkedIn posts have a 3000-character limit, so you can include more detail, but still keep it brief.
- Please refer to our writing tips for social media before writing your social posts.
- Please also check the copy using Grammarly (Octopus has a corporate license) and the Hemingway app to remove typos, grammatical errors, and passive voice.
- Submit your social posts in #topic-social-media.
The editing process takes time and we have a schedule of posts, so giving us at least 1 week's notice is preferred and appreciated. For time-sensitive posts, we'll do our best to get the post published as soon as possible. Please consider that the design team also needs time to create a blog image.