search

readthedocs / blog

Read the Docs blog
https://blog.readthedocs.com
18 stars 47 forks source link

Post: deprecation of building without config file #219

Closed humitos closed 1 year ago

humitos commented 1 year ago

Initial blog post to point users to when talking about the deprecation of "building without a configuration file".

I'm not mentioning a specific date on purpose here because we don't know yet. However, I'm mentioning Sept 2023 because our goal is to match with the drop of OpenSSL 1.1.1 support on urllib. We can update the post once we know this exact date and also write a new pretty small blog post with an update of the exact date later if we want to, but may not be necessary tho.

Once this blog post is published, we can update some links in the application to point users to this post also.

Note that I wrote a "suggested configuration file" and alos describe some of the differences, so users can dig a little more in case they start getting some errors. I don't want to give them just a blob of YAML without guiding the a little in the process.

📚 Rendered version 📚 : https://readthedocs-blog--219.org.readthedocs.build/migrate-configuration-v2/

Related https://github.com/readthedocs/readthedocs.org/issues/10351

humitos commented 1 year ago

I tested my suggested configuration file works at https://readthedocs.org/projects/test-builds/builds/20852204/

humitos commented 1 year ago

@benjaoming Thanks for the review 👍🏼. I took some suggestions that I found good and easy to apply. In particular, the addition of sections and the expansion of the dashboard settings since they have to be migrated as well. That was a good point that I missed 💯

humitos commented 1 year ago

OK. I will move forward with this PR and merge it so it's published and I can continue with the deprecation emails and notifications. I'm happy to come back to this blog post and update it as needed once people start reading it and having doubts/questions/things that are not clear.