Hi Eduard,
as you seem to have made up your mind about shutting down the MediaWiki despite peoples concerns (which I still don't think is a good idea to start with for the reasons explained before) let's start from there...
That's my call actually. The machine is ancient and osuosl are itching to get rid of it. We're using it for very little compared to the machine's power and I'd prefer if it were possible to fold in our services to use the website and the gitlab wiki.
*very* rare good and in my humble opinion we should abstain from spending it all on administrative tasks like splitting, moving, copyediting, whatever.
The content doesn't need to be copy edited. A lot of pages need to be archived and I think a archiving by default position would be a good start. Take what we need, as we know we need it.
I honestly have no idea what exactly you have in mind here. For "extension reference" do you mean "user documentation for existing extensions" (we have [1] but this is nothing that is ready for a wider audience, let alone translation) or "developer documentation on how to write extensions" (then I don't think it fits the category). Tutorials are already in share and all the rest sounds very vague.
[1] http://wiki.inkscape.org/wiki/index.php/Extension_reference
Extensions shouldn't be in the wiki anyway. Either they're for user consumption and should be on the website (where anyone can post one) or if committed they should be documented alongside the codebase. If in the future we split out our extensions repository, that's a task for another day.
#2 - Strictly user-facing pages in the wiki are moved to the main website. High level project info, roadmaps, user-oriented FAQs,
I'd vote roadmaps aren't user facing documents. They're develop documents. We may want to write news or campaigns about them for the website though.
but at that time a code change probably made it outdated or even
obsolete.
A lot of coder related documentation is actually in-line, some of it is build instructions, "getting started" that sort of thing. Generated docs aren't for committing and I expect we wouldn't actually have that many docs in the git repository, at least not separate from code.
But that'll be for us to proof as we see what kinds of pages are being archived out of the wiki. We'd only put things in the git repo if it made sense and I think Bryce is making room, even if the room isn't going to be used.
Again, what are "dynamic" development pages. As noted before I'd consider basically everything developer-related dynamic and I could live with having that all in a git*b wiki (do we really still call it git*b? For that decision it seems some people have already made up their mind, too).
I'd just keep these on the GitLab. If they're developer related and people are collaborating, the markdown wiki should be fine. For faster collabs we can still use google docs and paste into the wiki when they get stable (by which I mean edit time goes into the minutes as apposed to seconds.
Don't forget on GitLab you can save User wiki pages, and I recommend we encourage their use for drafting if people don't want to muck up the project wiki.
If you ask me that is actually the way I'd prefer and the only reasonable solution: Everything developer-related goes into a gitlab
Agreed, this is a good plan.
If we want to draw the line and shut down the MediaWiki do it correctly! The old content should not be easily accessible. If there is important content it *has* to be moved so that basically nobody will ever have a reason to look at the old Wiki again. If we can't manage that then we should not attempt the move at all (hence my initial doubts!). The worst case scenario I see is that Google indexes the old Wiki and people continue to work with that information while the new information is hidden somewhere deep in the VCS or gitlab.
No the media wiki content can be saved into a read-only directory on inkscape.org, so we can reffer to it but no editing. If edits are needed, then the content is moved to the right place.
No! Thinking about yet another Wiki is just stupid (sorry). Where do we save *any* resources by decommissioning the old MediaWiki only to create another (potentially Media-)Wiki, a gitlab developer Wiki and even more documentation in VCS?
I agree. We have enough tools to do this without a MediaWiki of any kind.
I hope you won't take any of that personal (it's certainly not intended that way!) but I really don't feel this is the correct direction...
No, good concerns, highly appreciated.
Best Regards, Martin Owens