AGS Awards nominations close at 13:59 GMT on Saturday 10 February 2018. You haven't yet nominated, so you've got 18 days and 10 hours left to play the games and decide which to nominate!

Author Topic: Wiki manual pages out of date  (Read 205 times)

cat

  • Mittens Baronet
  • AGS Baker
  • Learn to how write cat in Japanese!
    • cat worked on a game that was nominated for an AGS Award!
      cat worked on a game that won an AGS Award!
Wiki manual pages out of date
« on: 08 Dec 2017, 14:12 »
Wiki is like 10 years old compared to recent release, it is not even updated to AGS 3.2.1 (last version made by Chris Jones).
(I feel like repeating this for the 10th time in past couple of years, because people keep getting into similar situation :().
Maybe we should mark those wiki pages on the top of the page? We could make a banner that says "This article is outdated and only applies to old versions of AGS"

Crimson Wizard

  • AGS Project Tracker Admins
    • Best Innovation Award Winner 2013, for spearheading the AGS 3.3.0 project
    •  
    • Lifetime Achievement Award Winner
    •  
Re: Wiki manual pages out of date
« Reply #1 on: 08 Dec 2017, 14:38 »
Maybe we should mark those wiki pages on the top of the page? We could make a banner that says "This article is outdated and only applies to old versions of AGS"
Actually, all of the wiki pages that cite manual are outdated, and probably relate to AGS 3.1.*.
The separate online manual is corresponding to AGS 3.2.1.
IMO actual solution is in configuring a repository for documentation source, which anyone can edit, and which automatically builds online and offline version of the manual.

cat

  • Mittens Baronet
  • AGS Baker
  • Learn to how write cat in Japanese!
    • cat worked on a game that was nominated for an AGS Award!
      cat worked on a game that won an AGS Award!
Re: Wiki manual pages out of date
« Reply #2 on: 08 Dec 2017, 14:51 »
Actually, all of the wiki pages that cite manual are outdated, and probably relate to AGS 3.1.*.
Are they in a common category so they are easy to find? I really think we should mark them as outdated, so people know what they are dealing with.

Crimson Wizard

  • AGS Project Tracker Admins
    • Best Innovation Award Winner 2013, for spearheading the AGS 3.3.0 project
    •  
    • Lifetime Achievement Award Winner
    •  
Re: Wiki manual pages out of date
« Reply #3 on: 08 Dec 2017, 14:57 »
Actually, all of the wiki pages that cite manual are outdated, and probably relate to AGS 3.1.*.
Are they in a common category so they are easy to find? I really think we should mark them as outdated, so people know what they are dealing with.

Can't say if category is consistent (I hope so), there is one called "Manual entries".
There seem to be a plain copy of whole manual starting of the root page.

BTW, there is already a small message at the top of each page:
Quote
This page was last modified 19 August 2012, and could be out of date with the current AGS version.
Maybe people don't notice it?
« Last Edit: 08 Dec 2017, 15:05 by Crimson Wizard »

cat

  • Mittens Baronet
  • AGS Baker
  • Learn to how write cat in Japanese!
    • cat worked on a game that was nominated for an AGS Award!
      cat worked on a game that won an AGS Award!
Re: Wiki manual pages out of date
« Reply #4 on: 08 Dec 2017, 15:44 »
Ok, this is the template:
http://www.adventuregamestudio.co.uk/wiki/Template:Manual_entry

It links to http://www.bigbluecup.com/manual/ which, of course, doesn't work anymore. Is there an online version of the current manual somewhere? I'd try to update the template and add a warning about the outdatedness of those pages.

Oh, could you maybe split this discussion into a new thread? It is not related to the original topic anymore.

Crimson Wizard

  • AGS Project Tracker Admins
    • Best Innovation Award Winner 2013, for spearheading the AGS 3.3.0 project
    •  
    • Lifetime Achievement Award Winner
    •  
Re: Wiki manual pages out of date
« Reply #5 on: 08 Dec 2017, 16:17 »
It links to http://www.bigbluecup.com/manual/ which, of course, doesn't work anymore. Is there an online version of the current manual somewhere?
There's one linked on the AGS home page: http://www.adventuregamestudio.co.uk/manual/
It is also outdated and corresponds to 3.2.1.


Oh, could you maybe split this discussion into a new thread? It is not related to the original topic anymore.
Done.

cat

  • Mittens Baronet
  • AGS Baker
  • Learn to how write cat in Japanese!
    • cat worked on a game that was nominated for an AGS Award!
      cat worked on a game that won an AGS Award!
Re: Wiki manual pages out of date
« Reply #6 on: 08 Dec 2017, 16:25 »
So, there is no current version online? Is the chm file somewhere downloadable? Shall we link there? Or just add a note to use the manual that was shipped with AGS?

Crimson Wizard

  • AGS Project Tracker Admins
    • Best Innovation Award Winner 2013, for spearheading the AGS 3.3.0 project
    •  
    • Lifetime Achievement Award Winner
    •  
Re: Wiki manual pages out of date
« Reply #7 on: 08 Dec 2017, 16:34 »
So, there is no current version online? Is the chm file somewhere downloadable? Shall we link there? Or just add a note to use the manual that was shipped with AGS?

CHM is not the best way to distribute or link to, because it is only (officially) supported by Windows.
But when creating CHM the intermediate output is HTML files, which probably may be uploaded somewhere. Maybe that was the way online manual created?

cat

  • Mittens Baronet
  • AGS Baker
  • Learn to how write cat in Japanese!
    • cat worked on a game that was nominated for an AGS Award!
      cat worked on a game that won an AGS Award!
Re: Wiki manual pages out of date
« Reply #8 on: 08 Dec 2017, 17:35 »
Maybe that was the way online manual created?
Hm, probably. Can we do this again once the 3.4.1 is finished?