Working with GitHub is really much harder. I manage, but still find it difficult.
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!
Re: Current mediawiki is outdated and has security issues
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
Non native English speaker.
- adrianinsaval
- Veteran
- Posts: 5552
- Joined: Thu Apr 05, 2018 5:15 pm
Re: Current mediawiki is outdated and has security issues
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 ), 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.
Re: Current mediawiki is outdated and has security issues
It seems freecadwiki could work in tandem with FreeCAD-documentation if I am understanding this correctly.
Non native English speaker.
Re: Current mediawiki is outdated and has security issues
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)
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)
Re: Current mediawiki is outdated and has security issues
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.
Re: Current mediawiki is outdated and has security issues
We do that already.. But there are not many skilled with mediawiki AND willing to spend time on it...
Re: Current mediawiki is outdated and has security issues
How is readthedocs.org compared to mediawiki / git / ...
Re: Current mediawiki is outdated and has security issues
readthedocs renders docs nicely, but does not offer users easy ways to edit it...