Engineering Technical Writer

At bp, we provide an excellent working environment and employee benefits such as an open and inclusive culture, a great work-life balance, tremendous learning and development opportunities to craft your career path, life and health insurance, medical care package and many others.

We are seeking a skilled Engineering Technical Writer to create high-quality, developer-centric documentation that enables software engineers to effectively build, integrate, and scale our products. You will work closely with engineering, product, and developer experience teams to translate complex technical concepts into clear, accurate, and actionable content.

This role is ideal for someone who understands software development workflows and can connect with engineers in their language—through precise documentation, code examples, and structured technical content.

This role needs experience with CI/CD pipelines and DevOps practices and familiarity with cloud platforms (Azure, AWS, GCP)

Key Responsibilities:

Documentation Development

• Develop and maintain comprehensive technical documentation including:
• API references
• SDK guides and tutorials
• Architecture overviews
• Integration and onboarding guides
• Troubleshooting and how-to content
• Write clear, concise, and technically accurate content tailored to software engineers and developers
• Develop structured documentation that supports discoverability and usability (e.g., modular content, reusable components)

Developer Experience (DX) Enablement

• Produce practical, content (code snippets, walkthroughs, sample apps)
• Ensure documentation aligns with developer workflows and real-world use cases
• Advocate for developer usability in APIs and engineering designs through documentation feedback

Collaboration & multi-functional Work

• Partner with software engineers, architects, product managers, and DevOps teams to capture technical information
• Participate in sprint cycles, design reviews, and release planning to ensure documentation is accurate and timely
• Act as a link between engineering teams and external/internal developer audiences

Content Quality & Governance

• Maintain documentation standards, style guides, and guidelines
• Review and edit technical content given by engineers
• Ensure content is consistent, version-controlled, and aligned with product releases

Tooling & Automation

• Use and lead documentation tools such as static site generators (e.g., Docusaurus, MkDocs), Markdown, Git-based workflows
• Chip in to documentation pipelines (CI/CD for docs where applicable)
• Optimize content for searchability (SEO and internal search)

Technical Skills we need from you

• Bachelor's degree in Computer Science, Engineering, Technical Communication, or related field (or equivalent experience)
• 3+ years of experience in technical writing for software or engineering audiences
• Strong understanding of software development concepts (APIs, microservices, cloud systems, REST/GraphQL, etc.)
• Proficiency in reading and writing code in at least one programming language (e.g., Python, JavaScript, Java, C#)
• Experience with developer documentation tools:
• Markdown and Git workflows
• API documentation tools (e.g., OpenAPI/Swagger)
• Ability to quickly learn sophisticated technical systems and communicate them optimally.

Preferred Qualifications

• Experience documenting APIs, SDKs, or developer platforms.
• Familiarity with cloud platforms (Azure, AWS, GCP)
• Experience with CI/CD pipelines and DevOps practices
• Knowledge of developer portals and documentation frameworks
• Exposure to UX writing or developer experience design principles.

Key Skills

• Exceptional technical writing and editing skills
• Ability to simplify sophisticated technical concepts without losing accuracy
• Strong analytical thinking and attention to detail
• Developer empathy and understanding of engineering workflows
• Collaborator management and collaboration
• Driven with the ability to handle multiple documentation projects

Work You will Own

• Developer onboarding and quick-start guides
• API documentation and reference materials
• Code samples and tutorials
• Release notes and change logs
• Internal engineering documentation (optional depending on team)

Success Metrics

• Documentation usability and developer satisfaction
• Time-to-first-success for developers using the product
• Reduction in support tickets due to documentation clarity
• Documentation adoption and engagement metrics

Why join bp

Our purpose is to deliver energy to the world, today and tomorrow. For over 100 years, bp has focused on discovering, developing, and producing oil and gas in the nations where we operate. We are one of the few companies globally that can provide governments and customers with an integrated energy offering. Delivering our strategy sustainably is fundamental to achieving our ambition to be a net zero company by 2050 or sooner! At bp, we support our people to learn and grow in a diverse and ambitious environment. We believe that our team is strengthened by diversity. We are committed to fostering an inclusive environment in which everyone is respected and treated fairly.

Disclaimer

We are an equal opportunity employer and value diversity at our company. We do not discriminate on the basis race, religion, color, national origin, sex, gender, gender expression, sexual orientation, age, marital status, veteran status, or disability status. We will ensure that individuals with disabilities are provided reasonable accommodation to participate in the job application or interview process, to perform crucial job functions, and to receive other benefits and privileges of employment. Please contact us to request accommodation.

Even though the job is advertised as full time, please contact the hiring manager or the recruiter as flexible working arrangements may be considered.

We believe that our team is strengthened by diversity. We are committed to crafting an inclusive environment in which everyone is respected and treated fairly.

There are many aspects of our employees lives that are meaningful, so we offer benefits to enable your work to fit with your life. These benefits can include flexible working options, collaboration spaces in a modern office environment, and many others benefits.

What you can expect from us!

Our commitment to diversity, equity and inclusion:

At bp, you could be part of Business Resource Groups (BRGs) which believe in the power of inclusion, deeper connections, and shared experiences. They provide a place for employees to learn and share knowledge, to connect, and to improve. The BRGs focus on and encourage talent engagement, development, and retention while creating a broadened sense of community and inclusion for bp employees. The groups cultivate leadership growth by involving employees in developmental opportunities they would not otherwise have access to. Formal and informal mentoring also helps employees develop their professional goals and connect with colleagues. The BRGs dedication to growth at all levels helps employees feel more engaged and energized. The BRGs break down barriers, so we can all do better together. Examples of BRGs include (but are not limited to):

bpWIN (bp Women's International Network)

Pride

Working parents

PEN (Positively Ethnic Network)

bpInclusia (bp's Asian community)

bpEnergía (bp's Latin community)