GitHub wiki
dthompson

I've decided to make a serious go of moving/rewriting the content that's not hideously out-of-date from the Allegro.cc wiki over to GitHub. This stems from this thread, particularly SiegeLord's comment.

My main reasoning for this is as follows:

  • Aside from SiegeLord's macOS bundling tutorial, it's a clean slate.

  • It's hosted on a big site that isn't likely to go down any time soon; despite Tomasu's best efforts to keep the old wiki going, I hear he's had to nuke it before.

  • There aren't many better versioning tools than Git itself. Copy this link to clone the wiki's repo.

  • Closer proximity to Allegro's GitHub repository. Many people expect to find tutorials and articles on GitHub itself nowadays - either in the repo, the attached wiki, or a project's GitHub Pages site.

Unfortunately, the old wiki is chock-full of half-done and out-of-date articles. There's far too much of a focus on Allegro 4, the all-important Allegro Vivace sequel never got finished, and relevant info can be difficult to find. A quick look over the a.cc wiki should reveal the scale of the problem.

Have a look at the current progress and let me know your thoughts - particularly on the Quickstart and Vivace sections. I'd like to keep things trim and concise - other than for Vivace, which I've written thus far in as friendly a way as possible. Some ideas are already in place for later tutorials. Be braced for lots of TODOs; let's just hope they don't last as long as those on the a.cc wiki. 8-)

And, of course, please contribute :P it'd be good if we coordinated things from this thread if anyone else wants to get stuck in.

Eric Johnson

It looks pretty good so far. I'll try to contribute when I have time. Thanks for taking the initiative to start this. :)

Elias

Awesome!

GullRaDriel

Good idea anyway :D

dthompson

We've christened the new wiki repository. As before, anyone can edit, but those who want to do fancy stuff like uploading images or bigass attachments will need to request pull permissions.

Hopefully this will work well and spam+staleness will become things of the past. :)

Thomas Fjellstrom

If anyone wants the wiki database and images as a nice "big" (actually small) tarball, let me know.

It could concievably be scripted, and out of date stuff be pruned after the fact.

Mediawiki is a royal pain. Can't wait to be rid of it. :D

dthompson said:

I hear he's had to nuke it before.

I haven't had to nuke it, but some hardware failures, and backup failures have meant some changes have been lost at a couple different times.

dthompson

Mediawiki is a royal pain. Can't wait to be rid of it. :D

Wahey! 8-)

May well take you up on that offer of a tarball. Once Vivace is sorted, plan is to have a look through the old wiki to pick up any nuggets of info that may have been missed. So far, most of the stuff we've ported has been totally rewritten though.

Elias

Can you post the tarball here? And will the export be in a format we can plug into one of the many conversion tools like https://github.com/philipashlock/mediawiki-to-markdown?

Then we could just dump the result of that into a separate read-only github wiki and manually copy over useful pages.

dthompson

FYI, won't be giving this my attention for a few days as I'm switching jobs.

Thread #617535. Printed from Allegro.cc