potiuk commented on issue #48785: URL: https://github.com/apache/airflow/issues/48785#issuecomment-2788592514
Nice, @cmarteepants -> if you need any help with the doc update, do let me know, Sphinx is know to speak riddles and sometimes the issues it reports are ... weird - I tried to make the tooling way more friendly in #48760 and attempted to capture some most common "strange" issues in https://github.com/apache/airflow/blob/main/contributing-docs/11_documentation_building.rst . I got my own share of "head-scratchers" with the old ways - now when I split the documentaiton and modernized the code a bit, it should be nicer and easier. Also with @gopidesupavan we have a few tasks to improve publishing and possibly the CSS/Theme iteration. so later on we might also try to improve and get somoene to change the templates so that our doc also look better. I am at a conference in Raleigh now, so not fully available, but if you have any issues - either with the tooling or Sphinx, or any suggestions how to make doc contributions easiers, feel free to ping me. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
