Technical Writer II

The Position

Who We Are

The TechDocs team is a group of technical writers and engineers committed to ensuring that engineers at Twitter always have the information they need to succeed.

As a technical writer in Engineering Effectiveness, you will accelerate developer productivity by helping engineers from many different organizations author, discover, and consume organizational know-how as technical documentation. This role will be part of the TechDocs team, with a focus on short-term writing engagements and evangelizing technical writing best practices.

What You’ll Do

You will create technical user documentation for many teams at Twitter as you cultivate a culture of technical writing by helping our engineers explain and understand how to use our technologies more effectively.

  • Develop a good understanding of internal technologies and systems.
  • Plan, launch, and run documentation projects involving multiple subject-matter experts.
  • Work with engineering teams to identify customers, stakeholders, personas, and use cases.
  • Design information architecture plans for discoverable and maintainable engineering documentation.
  • Build architecture guides, procedural content, and reference documentation for engineers.
  • Edit, review, organize, and expand technical information from engineers for both internal (90%) and external publishing (10%)
  • Develop tooling and/or other resources to help engineers become more effective writers and communicators.
  • Deliver internal courses on technical writing concepts and tools to help foster a culture of documentation for both new hires and current engineers.
  • Create channels for technical writing feedback and workflows to improve the effectiveness of internal technical user documentation.
  • Create, test, modify, and improve sample code.


Who You Are

The successful candidate should be passionate about understanding and explaining new technologies and frameworks to others, communicate well, learn quickly, and be able to write and work with sample code in a variety of programming languages. This role will be presented with a variety of topics to contribute to, and a growth mentality is required.

  • BS/BA or equivalent work experience
  • Excellent written and verbal communication skills
  • 3 years of experience writing documentation for software developers or 2 years of software development experience with a passion for documentation
  • Familiarity with software engineering, system architecture, and other foundational technology concepts
  • Ability to read and understand multiple code paradigms at a high level
  • Ability to drive engineers and engineering managers to the successful completion of a project
  • Familiarity with one or more markup languages (e.g., Markdown, reStructuredText, Asciidoc, HTML)

The following would be nice to have:

  • Experience writing and maintaining documentation for an internal audience
  • Project management experience
  • Familiarity with programming languages, tools, and software development workflows (e.g., Python, Java,C++, Scala, Bash, Git)
  • Experience writing sample code
  • Experience using Jupyter Notebooks as executable documentation
  • Experience documenting APIs, frameworks, libraries, tools, systems, and workflows in domains such as web, mobile, distributed systems, data science, machine learning, and devops
  • Experience using Docs as Code tooling
  • Experience developing tools for authoring, publishing, discovering, or consuming docs

Company Description

Twitter is what’s happening and what people are talking about right now. For us, life's not about a job, it's about purpose. We feel real change starts with conversation. Here, your voice matters. Come as you are and together we'll do what's right (not what's easy) to serve the public conversation.

Additional Information

​​​​​Equal Opportunity Statement

We are committed to an inclusive and diverse Twitter. Twitter is an equal opportunity employer. We do not discriminate based on race, color, ethnicity, ancestry, national origin, religion, sex, gender, gender identity, gender expression, sexual orientation, age, disability, veteran status, genetic information, marital status, or any legally protected status.

A few other things we value:

  • Challenge - We solve some of the industry’s hardest problems. Come to be challenged, learn, and thrive as an engineer.
  • Diversity - Diversity makes us a better organization and team. We value diverse backgrounds, ideas, and experiences.
  • Work, Life, Balance - We work hard, but we believe with hard work should come balance.


Software Engineering


Remote Canada



U.S. Equal Employment Opportunity information (Completion is voluntary)
Non U.S. Equal Employment Opportunity information (Completion is voluntary)
Privacy and data