Working as a Rancher Writer

Join the Rancher Writers Network

Writers share their knowledge by researching and writing detailed technical articles on topics like Kubernetes, CI/CD, cloud-native application development, and more. After agreeing on a subject and an outline, writers conduct research, organize their ideas and write high-quality articles with clear language and detailed explanations. In most cases, Rancher writers conduct their own research, so it’s important that you’re comfortable learning processes and technologies that you're not familiar with.

If you enjoy researching more than writing, you may want to consider our research assistant role instead.

What's the Process?

We use the following workflow to align expectations and produce great content.

Join the Network

If this is your first time working on content with Rancher, your first step is to reach out to us.

Email content@rancher.com with the subject line "Rancher Writers Network" and include the following information:

  • Your name and contact information
  • Your background with containers, DevOps, Kubernetes, and related technology
  • Links to blog posts or other technical projects you have worked worked on in the past
  • A list of topics or subjects you're interested in

We will review your application as soon as possible and reach out if we think you’re a good fit.

Topic Discovery
and Project Scoping

Once you've joined Rancher Writers Network, the next step is to work with Rancher staff to come up with an appropriate topic and determine the project scope and deliverables.

This stage of the process involves:

  • Deciding on a topic
  • Determining project scope
  • Agreeing on deliverables and due date

If you have ideas for articles that you would like to write, let your Rancher contact know so they can verify that it is a good fit for the library and isn't currently being worked on by somebody else. Take a look at the Rancher content library to get a sense of the topics that are already available. Your contact may also provide you with a list of topics to choose from.

After agreeing on a topic, share a brief outline of what you think the article should cover to ensure that both sides agree on the appropriate scope for the project.

Writing the Article

Once your topic and outline are approved, it’s time to research and write your article. Read the Rancher community writing guidelines to learn how we write content at Rancher and remember to keep the project scope in mind as you write.

To get started, choose the article template below that best matches the style of your article:

Let your contact know if you have any questions throughout the process.

Your goal is to create the following:

  • A complete article, written as a single, plain-text document, formatted in Markdown
  • Any screenshots or supporting images referenced in the article. For diagrams and similar assets, feel free to create rough examples that we can use to produce finalized images.

When you are ready, submit the above pieces to the Rancher content team member you are working with.

Submission

Once you've created the above assets, submit them to your contact for review. We evaluate submissions by looking for the following qualities:

Faithfulness to the agreed upon outline and project scope

Completeness of the implementation

Accuracy and clarity of information

Correct use of grammar and voice

Adherence to the Rancher writing conventions

Your contact will let you know if your submission needs additional work any of the above areas. After you've satisfied the requirements, the team will prepare the piece for publication. You can then discuss additional articles you'd like to work on with the Rancher content team.

Get started with Rancher