Migrating parisc.wiki.kernel.org to RTD

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Greetings:

We are trying to sunset the last few wikis that we are hosting and convert
them all to git-backed sphinx documentation. The PARISC wiki is one of the
last MediaWikis that we have, and I have prepared a migration path for you
that I hope you will find suitable.

# Preliminary build

I have the preliminary conversion build available here:

https://www.kernel.org/doc/projects/parisc/index.html

The underlying repository for it can be found here:

https://git.kernel.org/pub/scm/docs/docsko/parisc.git/

The git repository includes the entire mediawiki history (excluding media),
plus the new source tree with the conversion results.

# Multiple RTD hosting options

If you would like to switch to the new sphinx-backed site, there are multiple
ways to host it:

1. You can clone that git repository and host it on github. This would allow
   for a quick readthedocs.org integration and allow you to edit the files
   directly via the github interface. This is a very wiki-like workflow and
   would allow you to grant access to the repository to anyone with a github
   account, plus accept pull requests with modifications. Once you have
   readthedocs.org integration working, we can configure it to be under the
   docs.kernel.org domain, which will allow you to remove the ads from the
   site.

2. Continue to host it in the current location and edit it with your
   kernel.org account credentials, plus accept edits via patches sent to this
   mailing list.

# Staying with mediawiki

I believe switching to sphinx-style documentation is the right way forward,
because wikis are increasingly problematic to host due to spam and hostile
scraper bots. By switching to RTD you also gain a lot more independence in
your hosting options, as the statically generated site can be put anywhere
capable of serving files.

However, if you're absolutely sure you want to stay with MediaWiki, we can
arrange hosting with OSUOSL, but it would need to be under a non-kernel-org
domain.

# What next?

Please let me know which way you would like to proceed in the next few days,
as I am hoping to sunset our last wikis by the end of October.

Best regards,
-- 
Konstantin Ryabitsev
kernel.org




[Index of Archives]     [Linux SoC]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux