Jibble

Author Topic: Broken links, etc. on AGS website  (Read 461 times)

Hobbes

  • Swashbuckler
Broken links, etc. on AGS website
« on: 31 May 2021, 13:05 »
As an initial clean-up, I thought it might help to collect all broken links on the AGS website as they've been reported by Babar, with perhaps some more added in as we browse through together. This could be step 1 in cleaning up the site before exploring a potential redesign as discussed here.

Some of my suggestions might be quite brutal, but I really think from a new-person perspective, if the first "Help and Support" links you find after downloading the editor don't work/are broken/are outdated, then that's a massive barrier to entry.

The main menubar AGS page (here)

Help and Support
The menubar on the right, under Getting Started, Help/FAQs, Art Tutorials & For Developers:

  • Video Tutorials - Don't exist. Let's delete this.
  • Getting Started with AGS - These are now static webpages and outdated (AGS3.0). Could we please transfer these into the Wiki so they can be collectively maintained?
  • Scripting Tutorial - Same as above. Last updated in 2007. Probably quite outdated but good to have. If it lives in the Wiki, we can make it a community effort.
  • GUI Scripting - Same thing again. This tutorial is rather outdated. But by transferring into the Wiki, we can modify.
  • Online manual - Please update the link to the current Github-one. This manual is for version 3.4.3
  • AGS Wiki - This should perhaps be the only link here. Help and Support required? Check out the Wiki!
  • Bug and Suggestion Tracker - This just takes you to the Forum? Should probably go to the Github Issues page
  • Beginners FAQ - This just takes you to the main page of the Wiki. Delete this link, the Beginners FAQ is on the Wiki, but let people just go to the Wiki through the link above and they'll find more resources there anyway.
  • Unofficial AGS blog - It's been quiet there for 7 years. Time to be removed from the website. I'm sorry SSH!! (All my love to the Scots, being married to one myself!)
  • AGS FAQ (non-technical) - Nice! But again, let's remove from here and stick it in the Wiki instead.
  • Kafka's Koffee - Delete. None of the links on that page work. Sorry!
  • AGS Engine Plugin API - Last updated 2009. Move to Wiki where it can be updated.
  • AGS Editor Plugin API - Can't see when this was updated... but again, let's move to the Wiki.

Now as cat said in the other thread I mentioned, AGS is a do-ology. I am MORE than willing to do these "move to Wiki" suggestions made above. I just want to make sure with AGA (or whoever needs to agree with this) that this will then mean the links on that page get edited/removed. Otherwise, it'll be a couple of hours wasted. So if whoever's in charge can give me the green light, I'll get the Wiki pages setup. And we can take it from there, update tutorials, etc.

Screenshots and Features on the same page
Simple suggestion, but could we add a Lightbox module? Right now, clicking on the screenshots opens them as bare pictures in a separate window.

Develop AGS
The only link there (the readme) takes you to Github. Perhaps just best to direct to Github anyway and make it clear that AGS is hosted there. I would "advertise" here as well that AGS falls under the Artistic License 2.0.

Resources
I question the need for this whole section on this page. It should live in the Wiki in its entirety. But not all of it, probably...
  • AGS Resources - I would... get rid. This is from 2006 and seems to be last updated September 2006. These things also live on the forum (in a more updated version) and can live in the Wiki. This is old and confusing.
  • Insta-Game - Whilst last updated in 2006, it's a collection of PNG files that people can use if they want to. Not confusing, I feel. But probably better linked to from the Wiki instead, on the Beginner / Getting Started Guide.
  • AGS Font Editor - Does this program still function? Perhaps this Resources sub-section would be a good place for community-designed software. But again, Wiki is probably better for this.
  • SCI Fonts - Again. Wiki, I feel.

The reason I keep saying Wiki-wiki-wiki should probably be clear by now. Community do-ology, it enables people who want to help out to help out. And we can easily take things further there together without it being a one-man responsibility when for all of us, time is precious.

eri0o

Re: Broken links, etc. on AGS website
« Reply #1 on: 31 May 2021, 13:14 »
https://github.com/adventuregamestudio/ags-manual

A lot of what you mention has simply being updated elsewhere in a different wiki. Just login on GitHub and you can Edit. I recommend first navigating to get familiar with the formatting.

Sure some can be ported back to the website, but it may need a different connection to pull the data.

The AGS website wiki page on fonts OTH though has been maintained by Monsieur OUXX, check that page history. https://www.adventuregamestudio.co.uk/wiki/Fonts

And there are things like the above that may not make sense in the manual but are still needed resources. I suggest you start cleansing the wiki and then start writing the skeletons of what you think makes sense there.

I think it would be useful to add HOW-TOs. See:


Some content can be lifted from forums for the wiki:
https://www.adventuregamestudio.co.uk/forums/index.php?topic=43629.0
« Last Edit: 31 May 2021, 13:49 by eri0o »

Re: Broken links, etc. on AGS website
« Reply #2 on: 31 May 2021, 16:10 »
IDK what were the video tutorials in the past, but these are Densming's ones which we use to recommend to the new users:
https://www.youtube.com/watch?v=1Ml_DR76Cl4&list=PL21DB402CB4DAEAEF

Snarky

  • Global Moderator
  • Global Moderator
  • Mittens Lord
  • Private Insultant
    • Best Innovation Award Winner 2018, for his numerous additions to the AGS open source ecosystem including the new Awards Ceremony client and modules
    • Snarky worked on one or more games that won an AGS Award!
    •  
    • Snarky worked on one or more games that was nominated for an AGS Award!
Re: Broken links, etc. on AGS website
« Reply #3 on: 31 May 2021, 20:31 »
On the other hand, I think we should add some kind of link to the AGS Discord. (Not sure exactly how to do that with the way Discord uses "invites" instead of links, but I've seen it in other places.)

  • AGS Engine Plugin API - Last updated 2009. Move to Wiki where it can be updated.
  • AGS Editor Plugin API - Can't see when this was updated... but again, let's move to the Wiki.

These, I feel, properly belong in the manual (they can be hidden away pretty far down), or perhaps somewhere on the AGS github. (It includes, among other things, a sample project to build.)
And it's not necessarily a problem that something was last updated in 2009 if there hasn't been a need to update it. As of a couple of years ago, at least, it still worked. In any case, I don't think the AGS Wiki is the right place.

Some tutorials could also be considered for inclusion in the manual.

Re: Broken links, etc. on AGS website
« Reply #4 on: 31 May 2021, 20:33 »
I started transferring plugin API pages to the manual:
https://github.com/adventuregamestudio/ags-manual/issues/134

Editor API is almost there, but for Engine API one would have to invest some time, because the markdown format we are using as a manual source currently is too different from html, and Engine API page has too many various formatting styles. I was not sure if it supposed to be copied as close as possible, or a new formatting made only copying the text.

The engine API was changed only once since, and it was my own change as noted in the changelog here:
https://www.adventuregamestudio.co.uk/forums/index.php?topic=58969.0
« Last Edit: 31 May 2021, 20:36 by Crimson Wizard »