Current mediawiki is outdated and has security issues

Discussions about the wiki documentation of FreeCAD and its translation.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
User avatar
Roy_043
Veteran
Posts: 8449
Joined: Thu Dec 27, 2018 12:28 pm

Re: Current mediawiki is outdated and has security issues

Post by Roy_043 »

yorik wrote: Thu Jun 30, 2022 10:14 am They have to ask for a wiki account too.
Working with GitHub is really much harder. I manage, but still find it difficult.
User avatar
Simbioz
Posts: 67
Joined: Tue Mar 30, 2021 2:55 pm

Re: Current mediawiki is outdated and has security issues

Post by Simbioz »

Roy_043 wrote: Thu Jun 30, 2022 10:32 am
Simbioz wrote: Wed Jun 29, 2022 12:44 pm
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.
Yes, I realized. But what is the alternative? To just change the documentation to whatever is I think is better/correct? Anyway, so far I am only committing minors edits (typos, add links, etc). In the discussion section I give MHO as to how could specific parts of the documentation be made more user/novice friendly.

It's a lonely road to travel :lol:
Non native English speaker.
User avatar
adrianinsaval
Veteran
Posts: 5541
Joined: Thu Apr 05, 2018 5:15 pm

Re: Current mediawiki is outdated and has security issues

Post by adrianinsaval »

Simbioz wrote: Thu Jun 30, 2022 6:10 pm But what is the alternative?
the forum?
User avatar
Simbioz
Posts: 67
Joined: Tue Mar 30, 2021 2:55 pm

Re: Current mediawiki is outdated and has security issues

Post by Simbioz »

adrianinsaval wrote: Thu Jun 30, 2022 7:33 pm
Simbioz wrote: Thu Jun 30, 2022 6:10 pm But what is the alternative?
the forum?
But specific threads get lost in subforums full of threads, like a single tree get's lost in the forest (I know the aphorism is the other way around, this is just my take on it 8-) ), so the information (comments about the page, the discussion section) is not as accessible as in the wiki, and I doubt someone who is browsing the wiki is gonna ask himself "what do other people think about modifying the contents of this specific subject" -before committing an edit- and do a search that might not necessarily show obvious result at first sight. So the answer is not so straightforward.
Non native English speaker.
User avatar
Simbioz
Posts: 67
Joined: Tue Mar 30, 2021 2:55 pm

Re: Current mediawiki is outdated and has security issues

Post by Simbioz »

It seems freecadwiki could work in tandem with FreeCAD-documentation if I am understanding this correctly.
Non native English speaker.
User avatar
yorik
Founder
Posts: 13640
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

Re: Current mediawiki is outdated and has security issues

Post by yorik »

I've tried many forms of git + mediawiki integration systems, but everything i tried didn't work too well.

In any case: We can continue with the wiki for as long as it is convenient. Also, there will always be people who prefer system XXX over system YYY. We need to assess IMHO what fullfills our needs best and also gives us the most sustainable solution (ie low maintenance, portable/exportable)
User avatar
Simbioz
Posts: 67
Joined: Tue Mar 30, 2021 2:55 pm

Re: Current mediawiki is outdated and has security issues

Post by Simbioz »

yorik wrote: Mon Jul 04, 2022 7:56 am We need ... the most sustainable solution (ie low maintenance, portable/exportable)
It seems the maintenance of the wiki is somewhat of a burden that falls in less than a handful of men. Maybe you could consider expanding the wiki maintenance team to a selected few you trust and are knowledgeable in the matter.
Non native English speaker.
User avatar
yorik
Founder
Posts: 13640
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

Re: Current mediawiki is outdated and has security issues

Post by yorik »

Simbioz wrote: Tue Jul 05, 2022 4:31 pm It seems the maintenance of the wiki is somewhat of a burden that falls in less than a handful of men. Maybe you could consider expanding the wiki maintenance team to a selected few you trust and are knowledgeable in the matter.
We do that already.. But there are not many skilled with mediawiki AND willing to spend time on it...
Jee-Bee
Veteran
Posts: 2566
Joined: Tue Jun 16, 2015 10:32 am
Location: Netherlands

Re: Current mediawiki is outdated and has security issues

Post by Jee-Bee »

How is readthedocs.org compared to mediawiki / git / ...
User avatar
yorik
Founder
Posts: 13640
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

Re: Current mediawiki is outdated and has security issues

Post by yorik »

readthedocs renders docs nicely, but does not offer users easy ways to edit it...
Post Reply