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.
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.
requirements-expected :
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.
