I’m curious if the Polkadot wiki is still being maintained actively/if there’s someone incharge - I was browsing through the website today and found programs in the ToC which no longer seem to be active for example 1KC and Dev Heroes program.
Edit: based on the response from Filippo and Dr. Radha, it seems to me that the Polkadot wiki team is overburdened and needs (a) more maintainers, (b) more community participation.
One of the issues that’s identified is the need to create a GitHub account which many community members may not have.
Hi @batman, yes, we finished migrating the Wiki from Docusaurus to MkDocs. We are currently working on the information architecture and content rehaul. We are three people working on quite a big documentation in a rapidly evolving space. Not as an excuse, but the Wiki is an open-source documentation for the community, and I feel the community should contribute more. Feel free to open an issue or a PR for review.
Please feel free to issue PRs or file issues when you see something out of date. The Polkadot Wiki is massive - printed out it would be three good-sized novels. Things occasionally get overlooked.
Polkadot Tech-Ed team has been really responsive and proactive to any suggestions or feature changes at the github repo.
You can just open a PR/issue at github as mentioned above.
Yeah, this is something to keep in mind. Users sometimes mention problems with the wiki in the Discord server, and I always point them to the github, but most people don’t have accounts there, don’t want to sign up there, and don’t know how to navigate the site. An alternative would be nice, if maybe not properly essential.
100% — I was just curious, because it was a part of the main navigation menu in the Explore page. But completely understand that it would be really difficult to maintain with just 3 people.
I’ll try and do my part and keep reporting issues to reduce some of the burden.
I’ve also edited the title and original post to reflect reality — it’s clearly being maintained, but seems to be overburden.
That makes me wonder, what could we do to maintain at least the major parts of the wiki properly? Off the top of my head a few things come to mind
Perhaps someone could be responsible for or separately employed part time for basic QA every week where they review the main navigation links and articles which should be archived if they are no longer relevant.
Having dedicated DRIs for each section could potentially make it more manageable to conduct thorough reviews.
Maybe having an editor with something like https://tina.io/ could encourage more contributions. Perhaps even wiki citation bounties?
This also ties into a broader effort of unifying the documentation within the ecosystem (and avoiding fragmentation). A full Wiki content scan is in the works before re-launching the Wiki by the end of this month or early next month. We will certainly think of feedback/reporting mechanisms for Wiki readers who may not have GitHub accounts to report issues. May be support tickets that can report Wiki inconsistencies?
Happy to reopen this conversation when we relaunch the Wiki as wiki.polkadot.com.
Filing an issue is quite easy: