Engineering Technical Writer

Entity: Technology Job Family Group: Engineering Group Job Description: 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.  

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)

Travel Requirement Up to 10% travel should be expected with this role Relocation Assistance: This role is not eligible for relocation Remote Type: This position is a hybrid of office/remote working Skills: API Development, CI/CD, Software Technical Writing, Stakeholder Management, Technical Writing, Writing Technical Documents Legal Disclaimer:

We are an equal opportunity employer. We do not discriminate on the basis of protected characteristics like race, religion, color, sex, national origin, sexual orientation, veteran status or disability status. Individuals with an accessibility need may request an adjustment/accommodation related to bp’s recruiting process (e.g., accessing the job application, completing required assessments, participating in telephone screenings or interviews, etc.). If you would like to request an adjustment/accommodation related to the recruitment process, please  contact us .

If you are selected for a position and depending upon your role, your employment may be contingent upon adherence to local policy. This may include pre-placement drug screening, medical review of physical fitness for the role, and background checks.