I’ve recently learned that the github wikies are not indexed by search engines. That makes the ProffieOS wiki a lot less effective in helping people. However, the question is what to do about it, like maybe:
Discourse has “wiki posts”, which basically just lets anybody edit the post.
However, it doesn’t really help with indexing, linking or organizing the wiki information. Also, I’m pretty sure that comments and discussion will get all blended up with the documentation content unless someone moderates and cleans things up.
Discourse does posting pretty well though, and it makes it easy to upload images and other media. (Github wiki is bad at pictures.)
True, but why?
The point of a wiki is to let pretty much anybody make changes.
(But let moderators change it back easily if someone messes with it.)
If it was just a matter of publishing pages, then I could just use my website.
It already works, try searching for “proffieos wiki where is my port” on google.
However, it doesn’t look very good, and all posted links are going to github, which means that the indexed content doesn’t get much of a boost from google’s pagerank algorithm.
Is the wiki only editable via browser? I tried to push from CLI and got remote: Permission to profezzorn/ProffieOS.wiki.git denied to NoSloppy. fatal: unable to access 'https://github.com/profezzorn/ProffieOS.wiki.git/': The requested URL returned error: 403
There is a link at the bottom to the Original page " Please visit the Original URL for working links and to view the page as intended!"
Interestingly, leaving “wiki” out of the query and doing just “proffieos sound”, it returned the original page as well as the wiki-see page in the results. Also note your site in there with the new Free Font Sounds page.
Lastly, I was able to add an image to the wiki pretty easily using Postimage’s “Hotlink for website”.
I’d have a team in a moderator group that manages the actual content. Have a sub forum where people can submit edits, which the team then enact or not. As a writer myself, I get the concept of wikis, but there’s a reason editorial control exists.
The ProffieOS wiki has been open for anybody to edit with no problems so far.
I know what it’s just a matter of time before someone tries to spam it or deface it, but removing barriers can be a really powerful thing too.
Ideally, I would want a wiki that has both options: Leave it open, and review changes after they are made, or close it and review changes before they go public. Possibly with some sort of trust system to let people who have made a couple of edits in the past do immediate edits. (Which might be a good reason to put the information here, since discourse has a trust system.)
That’s why I suggest having an editing team, with submissions from general users. You just give them permission to maintain the wiki subforum, and have them moderate the wiki amends subforum. It’s a semi open system. And you’d only have a handful of people properly editing a wiki anyway.
Also, from my experience, wikis tend to be an utter mess to read, bar a few.