Re: Migrating from perf.wiki.kernel.org to RTD

[Konstantin Ryabitsev <konstantin@linuxfoundation.org>]

On Fri, Oct 11, 2024 at 02:37:24PM GMT, Ian Rogers wrote:
> Hi Konstantin,
> 
> Yunseong created:
> https://perfwiki.github.io/main/

Oh, I wasn't aware of this effort. Would have saved me a good few hours. :)

> which looks superior to:
> https://git.kernel.org/pub/scm/docs/docsko/perf.git/
> as it is using markdown. Compare:
> https://git.kernel.org/pub/scm/docs/docsko/perf.git/tree/source/top_down_analysis.rst
> with:
> https://github.com/perfwiki/main/blob/main/docs/top-down-analysis.md

Well, this is just the github renderer. Github will happily render rst files
as well as markdown files. The reason I chose rst is because:

1. it's a better defined standard than markdown, which has as many flavours as
   there are forges, pretty much
2. the kernel already uses rst, so it's an easier switch for most kernel devs

> Perhaps the solution here is to make perf.wiki.kernel.org a redirect
> to https://perfwiki.github.io/main/

I'm happy to go either way, I just need the wiki to be gone. If this decision
is final, let me know and I will set the redirects.

-K