On Mon, Oct 14, 2024 at 10:57:02PM +0200, Helge Deller wrote: > It's really sad. Unfortunately, I believe that the time of wikis has passed. They have to be seriously locked down to avoid having to constantly fight spam, and this largely defeats the purpose of having a wiki at all, as opposed to any other publishing platform. In addition, in the past year we've seen more and more aggressive AI training bots descend on public resources and try to grab as much content as quickly as possible, which is both expensive in bandwidth and tends to result in poor performance for everyone. I am strongly convinced that going back to statically rendered sites is the way to go to avoid a lot of modern-day problems. > I was quite happy with mediawiki and the output was quite nice, at > least nicer than what RTD currently generates. Note, that the RTD output can be tweaked quite a bit -- I'm just using one of the stock themes with no customizations. I also noticed that the light theme looks much nicer on the front page than the dark theme due to all the logos. > I have not used RTD yet, so maybe someone here on the mailing list > has some knowledge and want to help? I'm happy to guide you along. I've added a readthedocs.yml and requirements.txt files to the repo: https://git.kernel.org/pub/scm/docs/docsko/parisc.git You can clone it and then push to your github or gitlab repo. After that, generating a readthedocs build is very easy: https://docs.readthedocs.io/en/stable/tutorial/index.html If you follow that, you should be able to get a build of the repository in 20-30 minutes. After that, you can even edit the documents directly on github and have them automatically rendered. Once you have it working on the readthedocs site, I can help you configure a docs.kernel.org domain and set the redirects from the old wiki. Let me know if that helps. -K
