Xonotic Forums
[SOLVED] Fixing the WIKI - Printable Version

+- Xonotic Forums (https://forums.xonotic.org)
+-- Forum: Creating & Contributing (https://forums.xonotic.org/forumdisplay.php?fid=10)
+--- Forum: Xonotic - Development (https://forums.xonotic.org/forumdisplay.php?fid=12)
+--- Thread: [SOLVED] Fixing the WIKI (/showthread.php?tid=5169)



Fixing the WIKI - nilyt - 11-17-2014

It's about time that we can really move on with the wiki and not be depending on the readonly copy left at dev.xonotic.org anymore.

Thanks to much work from divVerent there is a git-converted wiki at GitLab (wiki).
At this time there are two issues with it, though.
  • It has lost all the history of our helpful contributors, which is sad.
  • As GitLab doesn't really seem to support Textile (Redmine's) syntax (and probably because it's simply easier to handle) conversion to Markdown was necessary.
    In the process, a lot of markup went boom and pages simply look ugly or even broken right now.

So I went through the ardous task of first going through all the page histories on dev.xonotic.org and typing all the versions and changes down as git commits, so that we can keep attributing all the helpful people who brought content into it. I'm joking, of course I did it with a big script.

The next part will be converting that to Markdown now, or probably merging divVerents conversion on top,
and fixing previously redmine-hosted images. I will also put (most) external images locally as well, since links tend to go dead and I think it's good to have the wiki more self-contained. There are enough dead links in there already.


Before all that, I want previous wiki contributors to check the Redmine wiki for their old userdata, and let me know if they want it changed, in git.
Why? When exporting Redmine I used the redmine user data, obviously. Including email where they were set public.
Since the redmine accounts were a different database than the forums or git, some people have had different credentials there, than they might for other Git contributions.


Where I could find any obviously matching handles in our git history, I already changed over name/email for these users.
Left over are users without any valid email address ("username@" -- which is fine if they want it kept that way).

But I'd like anyone there to have a chance to change this data, before it is committed to eternal history.

- If you have a GitLab account, and want your old wiki contributions attributed to it now, you would use the email you have registered there.
- Since the repos are mirrored to GitHub, if you have GH account and want your contributions attributed to it, you would use your email from there.
- Maybe your Redmine email was only public because you forgot to set it private, but you don't want to be associated with that email in git, then let me know another handle to replace it with.
- Or you just use a different name in git commits and want your redmine username replaced with that.

Now is the only chance of rewriting history Big Grin
What I need to know:
- current user
- replacement username and mail (or no mail, or no change).
If you don't want to have that request public, send me a PM with the info.

To find yourself, check
http://dev.xonotic.org/projects/xonotic/wiki.html > your changes > History> Author
https://gitlab.com/nyov/xonotic/wikis/pages > page > History
https://github.com/nyov/xonotic/wiki/_history
As github and gitlab don't show emails, for good reason, you'll have to clone the repo to see if your email is empty, or not the one you would expect it to be.
(Some page links will be broken there now, so use the "pages" overview to navigate. Those forks will go away in a week.)

(Edit: Find the wiki at the official location now: https://gitlab.com/xonotic/xonotic/wikis/home )

If the change is non-obvious, I have ask for some kind of verification, so nobody gets to steal or deface other users.

To set a limit on this intrusive history change, so we can move on, this offer is valid for a week from now on. Say, until next Sunday.

(Edit: Time's up. Timemachine destroyed. can't change history anymore now. Tongue)


RE: Fixing the WIKI [concerns all previous contributors] - Mr. Bougo - 11-18-2014

Wow, nice! No changes required for me, I think.

EDIT: Ah, FWIW, I already redid the formatting on the current version of the hardware requirements page.

Also, are your scripts out there? I'm just being curious Smile


RE: Fixing the WIKI [concerns all previous contributors] - nilyt - 11-18-2014

(11-18-2014, 01:37 AM)Mr. Bougo Wrote: Wow, nice! No changes required for me, I think.

EDIT: Ah, FWIW, I already redid the formatting on the current version of the hardware requirements page.

Great. Yeah I'll merge those commits in, not disregarding the previous work done there.

(11-18-2014, 01:37 AM)Mr. Bougo Wrote: Also, are your scripts out there? I'm just being curious Smile

Sure Smile
https://gitlab.com/xonotic/xonotic/commit/a2633873cf8e8bf008b4b49904d322ddadd4eedf
Not sure about this, but https://gitlab.com/xonotic/xonotic/merge_requests/3


RE: Fixing the WIKI [concerns all previous contributors] - Mr. Bougo - 11-18-2014

Cool, thanks! I'm bookmarking this.


RE: Fixing the WIKI [concerns all previous contributors] - nilyt - 11-22-2014

And time's up.
I'm going to push the fixed wiki now, so everyone can go forth and make it even better.

Yeah, well, I can dream, right?


RE: Fixing the WIKI - JoeMaro - 01-22-2015

would be nice if the Wiki Link here on the page links there no?
first time i saw this nice wiki Smile the one that is linked now is not good


RE: Fixing the WIKI - Mr. Bougo - 01-22-2015

(01-22-2015, 02:22 PM)JoeMaro Wrote: would be nice if the Wiki Link here on the page links there no?
first time i saw this nice wiki Smile the one that is linked now is not good

Your "nice wiki" is read-only and dead.

Can you explain why you think the one linked now is not good? We ported the content of the old one over but formatting issues may remain.


RE: Fixing the WIKI - JoeMaro - 01-22-2015

sorry guess i wasnt really clear:
so the GitLab wiki is the new wiki i understand (?) and xonotic.org still links to the old one (community -> wiki).
in the past i repeatedly tried to find help in the old wiki but didnt succeed.
Hope i dont confuse old and new here.
Thnx!


RE: Fixing the WIKI - Mr. Bougo - 01-22-2015

Right. The old one is archived here: http://dev.xonotic.org/projects/xonotic/wiki.html
The new one is located here: https://gitlab.com/xonotic/xonotic/wikis/home

The new one should have the old one's content, but formatting hasn't been updated to the new wiki's format, so it may look ugly. It's a wiki though, so we hope that over time the most important content will get prettier Smile


RE: Fixing the WIKI - Antibody - 01-23-2015

We're in the process of switching websites. After that time I'll ask the community to find any bugs or obvious dead links. At the moment I'm not putting any more effort into updating the existing one since it will be thrown away shortly anyway.