wiki.dlang.org: How about replacing MediaWiki with a Git repo?

Mindy Batek (0xEAB) desisma at heidel.beer
Tue Aug 4 16:58:43 UTC 2026


On Tuesday, 4 August 2026 at 12:34:16 UTC, Vladimir Panteleev 
wrote:
> If we wanted to entertain that thought, I think the conclusion 
> is then that we should enable logging in via GitHub, not throw 
> the baby with the bathwater.

We should scrutinize the current solution to the same criteria 
that we apply to other proposals.

> I appreciate the feedback, but I think the kind of feedback 
> that would lead to any actual changes needs to come from a 
> place of proven and long-term experience from running such 
> community services, as well as commitment to support these 
> choices going forward.

We tried MediaWiki for documentation at work. A coworker said he 
had used it in a previous workplace.
In my opinion, it was a bit clunky. It was rather unhandy. It 
didn’t fit in with other workflows. People didn’t write 
documentation. They couldn’t be bothered to bother using the tool 
provided.
When we switched to a Markdown-based solution (MkDocs) and used a 
Git repo for versioning, documentation got suddenly taken 
serious. People could use their favorite editor for authoring. No 
complicated data transfer for such a workflow, just save the 
files to your filesystem and let Git handle the rest. The thing 
is automatically deployed to a webserver where docs can be read 
and searched.
Those who aren’t as familiar with Git or text editing just use 
the web interface.
Thanks to GitLab’s Web IDE, we even use it for meeting protocols 
these days.

We even have repositories shared with less tech-savy clients so 
we can maintain their documentation together. It works.

Obviously, this isn’t all that comparable. At work we do not use 
pull requests (or merge requests, how GitLab calls it). The 
content is internal only, not publicly on the internet for 
everyone to view. And after all, it’s just my anecdote, not a 
scientific study.


More information about the Digitalmars-d mailing list