Fixing broken links in Wiki (Articles Tutorials)

plicatibu · November 2019

Hi, guys.

First broken link fixed.

The item Graphics -> Drawing Bitmaps in wiki page Articles Tutorial was pointing to tutorial Displaying Images made by Jason Oakley (that's the original URL: http://bluebilby.com/2013/04/14/gideros-mobile-tutorial-displaying-images).

I retrieved content of Jason Oakley' tutorial from webarchive.org and put it in a new page named Drawing Bitmaps that I created in the wiki.

Finally I edited the Articles Tutorial page so that item Graphics -> Drawing Bitmaps were pointing to the new page.

Of course I put a note on the page giving all credits to the author with a link to their profile in his own web site.

I'm planning to do the same for all broken links.

Let me know if you have something against it.

Regards.

MoKaLux · November 2019

@plicatibu welcome to the party

plicatibu · November 2019

Now the third broken link was fixed (the second one was mentioned here).

The item Graphics -> Drawing text with TextField in wiki page Articles Tutorial was pointing to tutorial Drawing Text made by Jason Oakley (that's the original URL: http://bluebilby.com/2013/04/06/gideros-mobile-tutorial-drawing-text/).

Now it has its own wiki page here.

MoKaLux · November 2019

very good job, thank you for these

rrraptor · November 2019

I have never used any tutorials besides Box2d to learn gideros

All I need is a few examples and good engine reference page. And the old gideros refernce page was good (at least for me), I like that you had everything in one place, and how thing organized. On the left we had list of all availiable classes, and class methods (if it gets selected), on the right - class method description that was selected on the left panel, at the top - a few tabs: "Plugins", "Lua" and somethig else, so if you forgot for example how to use enhancements operators (like >< or <>) you just need to switch tab to "Lua" and there you have exactly same interface.
But right now we have a lot of pages which reduces refernce usability a lot. You cant quickly switch between classes reference page, you have to go back to "Main API" page. Yes you can use "Last 8 Pages Viewed" to quickly go to that main page, but it is 8 last pages, and if there is no link to main page, you have to go all the way back to hame page. Same for other pages.

P.S. Sorry for my English

MoKaLux · November 2019

rrraptor said:
And the old gideros refernce page was good (at least for me), I like that you had everything in one place, and how thing organized. On the left we had list of all availiable classes, and class methods (if it gets selected), on the right - class method description that was selected on the left panel

I agree with you. In wikimedia I understood from somewhere in this forum that it was quite a pain to implement

I am thinking about reorganizing the wiki front page but we need to discuss it all together.
For the front page I am thinking something like the way they do it in processing: https://processing.org/reference/

SinisterSoft · November 2019

Now all the upload of the doc data to the wiki has been done, you can add the extra pages to add what you need to the Wiki to show what you want, where you want.

antix · November 2019

I agree with @rrraptor in that it is now more difficult to quickly find information.

oleg · November 2019

antix said:
I agree with @rrraptor in that it is now more difficult to quickly find information.

You can always use the old version
http://docs.giderosmobile.com/reference/

keszegh · November 2019

oleg said:

antix said:
I agree with @rrraptor in that it is now more difficult to quickly find information.
You can always use the old version
http://docs.giderosmobile.com/reference/

but this is not up-to-date, is it? (i also prefer the old one functionality-wise)

oleg · November 2019

keszegh said:

oleg said:

antix said:
I agree with @rrraptor in that it is now more difficult to quickly find information.
You can always use the old version
http://docs.giderosmobile.com/reference/
but this is not up-to-date, is it? (i also prefer the old one functionality-wise)

New documentation is generated automatically, Old site is hard to edit.

Let the guys prepare a new release Gideros rather than design documentation!

plicatibu · November 2019

Now the fourth broken link was fixed.

It's the item Graphics ->The MovieClip animation class in wiki page Articles Tutorial was pointing to Animated Movieclips tutorial made by Jason Oakley (that's the original URL: https://web.archive.org/web/20160710034029/http://bluebilby.com/2013/05/12/gideros-mobile-tutorial-animated-movieclips/).

Now it has its own wiki page here.

plicatibu · November 2019

Now the fifth broken link was fixed.

It's the item User Input and Controllers -> Touch and mouse input in wiki page Articles Tutorial was pointing to Touch Input and Mouse Input tutorial made by Jason Oakley (that's the original URL: http://bluebilby.com/2013/04/26/gideros-mobile-tutorial-touch-input-and-mouse-input/).

Now it has its own wiki page here.

plicatibu · November 2019

Now the sixth broken link was fixed.

It's the item User Input and Controllers -> Keeping track of touched Sprites in wiki page Articles Tutorial was pointing to Object IDs tutorial made by Jason Oakley (that's the original URL: http://bluebilby.com/2013/04/30/gideros-mobile-tutorial-object-ids/).

Now it has its own wiki page here.

plicatibu · November 2019

Now the seventh broken link was fixed.

It's the item File I/O -> Loading and saving data in wiki page Articles Tutorial was pointing to Loading And Saving Data tutorial made by Jason Oakley (that's the original URL: http://bluebilby.com/2013/05/04/gideros-mobile-tutorial-loading-and-saving-data/).

Now it has its own wiki page here.

MoKaLux · November 2019

super cool thank you @plicatibu

plicatibu · November 2019

@MoKaLux I'm enjoying it a lot because before editing the pages I create the projects and test them.

I believe that in this weekend I'm going to watch your videos (and of course making tje projects)

MoKaLux · November 2019

I am also a beginner. I am using gideros since a couple of months (10 months). Like you I decided to help the community

plicatibu · November 2019

I'm a beginner. You, after 10 months using Gideros is at least an "advanced beginner".

MoKaLux · November 2019

antix · November 2019

@oleg, the old version is just that... old, and does not contain all of the information contained in the Wiki. It's really bad practice to have such fragmentation, especially in documentation.

hgy29 · November 2019

Old documentation shouldn’t be used. Is there any links still pointing to it ?
We decided to leave it online when we switched to the wiki to give us a chance to recover stuff that wasn't properly migrated. Should I put it offline now ?

keszegh · November 2019

remove links for sure and add info on top that it's outdated but please leave it online if possible.

SinisterSoft · November 2019

@hgy29 Maybe change the URL slightly if possible so that search engines start to lose it.

oleg · November 2019

SinisterSoft said:
@hgy29 Maybe change the URL slightly if possible so that search engines start to lose it.

I understand you correctly so that people do not say that they do not like the new documentation, do you want to prevent people from using the old documentation?

hgy29 · November 2019

oleg said:

I understand you correctly so that people do not say that they do not like the new documentation, do you want to prevent people from using the old documentation?

The old documentation is out of date, so it can be misleading. Do we want newcomers to use old docs instead of more accurate ones ? I think @sinistersoft is right, one thing to do, if not shutting down old doc, would to change its path. When you search for gideros api docs from google, most results come from the old site.

Apollo14 · November 2019

hgy29 said:

oleg said:

I understand you correctly so that people do not say that they do not like the new documentation, do you want to prevent people from using the old documentation?
The old documentation is out of date, so it can be misleading. Do we want newcomers to use old docs instead of more accurate ones ? I think @sinistersoft is right, one thing to do, if not shutting down old doc, would to change its path. When you search for gideros api docs from google, most results come from the old site.

If possible, please leave old docs (personally I use them more, though I know that they're deprecated).
If you want Google to remove them from search base, you can place robots.txt file in the root directory of subdomain:
http://docs.giderosmobile.com/robots.txt
With content:

Disallow: /
Host: wiki.giderosmobile.com

This way Google will know that docs.giderosmobile.com is deprecated and wiki.giderosmobile.com should get ranking priority.

oleg · November 2019

hgy29 said:

oleg said:

I understand you correctly so that people do not say that they do not like the new documentation, do you want to prevent people from using the old documentation?
The old documentation is out of date, so it can be misleading. Do we want newcomers to use old docs instead of more accurate ones ? I think @sinistersoft is right, one thing to do, if not shutting down old doc, would to change its path. When you search for gideros api docs from google, most results come from the old site.

You now confirmed my words, you want to destroy the old documentation because people do not like the new - it is not logical

There are a bunch of other sites on the internet that provide outdated information and you can't influence it, so it is not logical to remove the old Google page from indexing - it will only hurt the Gideros site. And beginners have the choice to use Google search or Wikipedia. Everyone knows that official information is listed in the Gideros help desk, and Google searches are additional information.

keszegh · November 2019

@hgy29 , i think you could leave the old reference there as many (including me) prefer it even if it is outdated. just add a big sign at the top that it is deprecated, covers only an older gideros version (say which) and provide a link to the up-to-date wiki reference.
therefore if somebody finds it via google search will immediately know what is the status of that page.

Apollo14 · November 2019

oleg said:

hgy29 said:

oleg said:

I understand you correctly so that people do not say that they do not like the new documentation, do you want to prevent people from using the old documentation?
The old documentation is out of date, so it can be misleading. Do we want newcomers to use old docs instead of more accurate ones ? I think @sinistersoft is right, one thing to do, if not shutting down old doc, would to change its path. When you search for gideros api docs from google, most results come from the old site.
You now confirmed my words, you want to destroy the old documentation because people do not like the new - it is not logical

There are a bunch of other sites on the internet that provide outdated information and you can't influence it, so it is not logical to remove the old Google page from indexing - it will only hurt the Gideros site. And beginners have the choice to use Google search or Wikipedia. Everyone knows that official information is listed in the Gideros help desk, and Google searches are additional information.

Probably another good option is to leave old docs, but add big banner somewhere in the header, with warning that these docs may be outdated.

P. s. Imo new wiki is awesome.

hgy29 · November 2019

I never said I want to remove them, I just thought it could be a good idea. I don’t own gideros, so whatever you guys think is best, let’s do it.

Howdy, Stranger!

Categories

In this Discussion

Top Posters

Fixing broken links in Wiki (Articles Tutorials)

Comments

Howdy, Stranger!

Quick Links

Categories

In this Discussion

Top Posters

Fixing broken links in Wiki (Articles Tutorials)

Comments