May I also point out that version 1.38 (15 March 2022) is the current stable one.Warning: MediaWiki 1.35.0 to 1.35.4 contain a very severe security issue. Please upgrade to 1.35.5 or later. See 2021-12 security release/FAQ for more information.
Current mediawiki is outdated and has security issues
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
Be nice to others! Respect the FreeCAD code of conduct!
Current mediawiki is outdated and has security issues
According to https://wiki.freecadweb.org/Special:Version, freecad wiki is at 1.35.2. Also, it's stated in https://www.mediawiki.org/wiki/MediaWiki_1.35 that:
Non native English speaker.
Re: Current mediawiki is outdated and has security issues
@yorik @kkremitzki
Re: Current mediawiki is outdated and has security issues
The mediawiki software is a hard-to-manage dinosaur... That's the main reason why I'm pushing for a markdown-based system
Will have a look at this with @kkremitzki
Will have a look at this with @kkremitzki
Re: Current mediawiki is outdated and has security issues
According to this site (yes it's from a competing wiki system but it seems quite neutral), most premium grade alternatives to mediawiki are paid. Free ones like DokuWiki and Wiki.js both have drawbacks. The former is designed for small, lightweight wikis, and the latter seems to lack many features and suffers from UI bugs. Plus, you will probably want an "import" function to migrate all the content...
So at first sight the picture is not very promising
Non native English speaker.
Re: Current mediawiki is outdated and has security issues
But we are not seeking another system. We HAVE another system already: https://github.com/FreeCAD/FreeCAD-documentation
It is meant to use in FreeCAD via the Help addon (which should not be an addon anymore and become fully integrated once working perfectly) but also to generate books, pdf, and whatsoever.
It is currently an automatic translation of the wiki, but at some point when we decide we don't want the wiki anymore, it can fly by its own wings. I think nowadays editing a markdown file on github/gitlab/whatever is as easy as editing the mediawiki, plus we have billions of other advantages: there is no more dependency on any software, there is easy backup as many copies circulate the web, we can plug it into a translation system such as crowdin, we can have release tags that match the FreeCAD releases, we can generate API documentation easily, etc...
It is meant to use in FreeCAD via the Help addon (which should not be an addon anymore and become fully integrated once working perfectly) but also to generate books, pdf, and whatsoever.
It is currently an automatic translation of the wiki, but at some point when we decide we don't want the wiki anymore, it can fly by its own wings. I think nowadays editing a markdown file on github/gitlab/whatever is as easy as editing the mediawiki, plus we have billions of other advantages: there is no more dependency on any software, there is easy backup as many copies circulate the web, we can plug it into a translation system such as crowdin, we can have release tags that match the FreeCAD releases, we can generate API documentation easily, etc...
Re: Current mediawiki is outdated and has security issues
But let's not forget that there are also some disadvantages. The main two are:
- For casual editors the Wiki is more accessible. Having to create a GitHub account to edit the new documentation will be a barrier for some.
- We use many templates on our Wiki pages. Markdown does not seem to support those. This will probably mean that our layouts will have to be simplified.
Re: Current mediawiki is outdated and has security issues
I may have overlooked it, but I did not happen to find a "discussion" section for each page on the github documentation.
Non native English speaker.
- adrianinsaval
- Veteran
- Posts: 5551
- Joined: Thu Apr 05, 2018 5:15 pm
Re: Current mediawiki is outdated and has security issues
Also casual editors would have to make PRs for their edits and someone will need to spend time approving each one
Re: Current mediawiki is outdated and has security issues
All these are of course valid concerns, but:
They have to ask for a wiki account too. Which is far more annoying, one needs to first post on the forum, then send a DM, then an admin has to act...
That is true. Indeed this move would lead to some simplification. But that would not necessarily be a bad thing IMHO
No, but on the other hand we would have issues, could comment on commits, have pull requests...
That could be rather a good thing, no? And we could be rather liberals with permissions, and give write permission to all frequent contributorsadrianinsaval wrote: ↑Wed Jun 29, 2022 3:30 pm Also casual editors would have to make PRs for their edits and someone will need to spend time approving each one
Re: Current mediawiki is outdated and has security issues
I see that you are using the Discussion pages on the Wiki. Keep in mind that very few editors, if any, consult them. Almost all Discussion pages are empty.