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)