We are supporting a documentation-focused initiative that requires advanced customization of Sphinx-based sites. The project involves building and maintaining fully tailored Sphinx themes, improving the documentation layout, and ensuring a consistent, responsive user experience across devices. You will collaborate closely with technical writers and engineering teams to enhance the structure, design, and usability of the documentation platform.

Sphinx/Jinja2 Web Developer

Your responsibilities

• Develop custom Sphinx themes using Jinja2, CSS, and JavaScript.
• Configure and optimize the Sphinx environment, including updates to conf.py and build pipelines (e.g., make html).
• Implement responsive UI components and layouts, ensuring usability across various breakpoints.
• Enhance navigation flow, breadcrumbs, and overall site interactions.
• Maintain and improve the documentation structure, page templates, and list-view layouts within Sphinx.
• Ensure correct linking, hierarchy, and consistency across the entire documentation site.
• Collaborate with engineering and documentation teams to refine visual and structural aspects of the platform.

Our requirements

• Solid experience with Sphinx and proficiency in Python sufficient to configure and troubleshoot the build environment.
• Strong skills in Jinja2 templating, CSS, and JavaScript for custom theme development.
• A frontend-oriented mindset with a focus on responsive design, layout optimization, and smooth user navigation.
• Deep understanding of Sphinx documentation architecture (pages, list-views, linking strategies, navigation patterns).
• Ability to work independently and propose improvements to existing documentation frameworks.