These docs are *very* out of date

Solar2D General Questions/Discussion
#1

There has been a problem with this site since i paid for the my subscription 6 months ago.

When searching for information about corona it is better to use google as the site search is split up to search so many sub-groups individually, it is next to useless.

Unfortunately when searching with google you often get sent to the old docs… however after taking time to search for something specific and then getting this message ;-

"These docs are *very* out of date. 

You will be redirected to the new docs in a few seconds. 

If you are certain you want to see the old docs, click cancel."

You get taken to the root of the API documentation, which is not the same level as a full tutorial you were expecting. Its a waste of my time and your bandwidth as i will just go back to google and try another link.

Can i ask simply why there is no redirects set for all this, there is no appropriate use of HTTP codes to tell google all its old content has been re-directed.

Put simply, given you guys can clearly manage to code quite well, why is the website still in this strange half-way house between old and new, where it seems much of the old useful information is simply not there anymore?

#2

EVEN THE NEW API DOCUMENTATION LINKS TO THE OLD ONE…

See:-

http://developer.coronalabs.com/category/api-tags/scrollview

The link to “Read this Tutorial” relating to a maskfile.

Then also here;-

http://docs.coronalabs.com/api/library/widget/newScrollView.html

And see the link there about creating a bitmask file.

Seriously can you guys sort this out so we can at least find consistently accurate documentation, today i am wasting time searching for information badly linked in the vendor website!!! 

#3

Hi Jeremy,

I apologize for this; I’m personally in the process of locating and nailing down these old “outdated docs” links. The problem is that they turn up in so many random places, it’s a difficult task to locate them all and redirect them.

This coming week I’m going to do another search roundup and get rid of more bad links. Please just be patient a bit longer… the process of changing over guides and documentation is time-consuming.

Thanks,

Brent

#4

Thanks for the prompt reply.

The problem you describe is something affecting the whole internet. There is so much old and out of date content out there searching with google is getting harder and harder.

One reason i think this happens is due to the insane love of blogs that is going on where “content” is stored by date so not easily searchable on the site that hosts it, but still out there and indexed by google so 4 year old tutorials can rank higher than 1 month old ones.

It is surely a difficult taks for 1 person, so perhaps it would be easier to write a little script that allows people to submit broken links, or just search your server logs for redirects.

I hope this helps.

Jeremy

#5

Hi Jeremy,

Thanks for the input. Just as a reference, any docs/guides at the “developer.coronalabs.*” scope are being gradually phased out. Some will remain longer than others, but the eventual goal is to fix all links to docs/guides in that locale scope.

Going forward, many guides and APIs will be on the “docs.coronalabs.*” scope. For example, this one you found:

http://docs.coronalabs.com/api/library/widget/newScrollView.html

The best way to report issues on these pages, if you find them, is to “rate” them using the 3 buttons at the bottom. For example, on this page you found, there’s a link that leads to an older guide on bitmap masking. If you go to the bottom of the original page and click “Like it, but…” or “Hate it”, and submit a quick reason why, this will bring it to our attention immediately.

Thanks,

Brent

#6

EVEN THE NEW API DOCUMENTATION LINKS TO THE OLD ONE…

See:-

http://developer.coronalabs.com/category/api-tags/scrollview

The link to “Read this Tutorial” relating to a maskfile.

Then also here;-

http://docs.coronalabs.com/api/library/widget/newScrollView.html

And see the link there about creating a bitmask file.

Seriously can you guys sort this out so we can at least find consistently accurate documentation, today i am wasting time searching for information badly linked in the vendor website!!! 

#7

Hi Jeremy,

I apologize for this; I’m personally in the process of locating and nailing down these old “outdated docs” links. The problem is that they turn up in so many random places, it’s a difficult task to locate them all and redirect them.

This coming week I’m going to do another search roundup and get rid of more bad links. Please just be patient a bit longer… the process of changing over guides and documentation is time-consuming.

Thanks,

Brent

#8

Thanks for the prompt reply.

The problem you describe is something affecting the whole internet. There is so much old and out of date content out there searching with google is getting harder and harder.

One reason i think this happens is due to the insane love of blogs that is going on where “content” is stored by date so not easily searchable on the site that hosts it, but still out there and indexed by google so 4 year old tutorials can rank higher than 1 month old ones.

It is surely a difficult taks for 1 person, so perhaps it would be easier to write a little script that allows people to submit broken links, or just search your server logs for redirects.

I hope this helps.

Jeremy

#9

Hi Jeremy,

Thanks for the input. Just as a reference, any docs/guides at the “developer.coronalabs.*” scope are being gradually phased out. Some will remain longer than others, but the eventual goal is to fix all links to docs/guides in that locale scope.

Going forward, many guides and APIs will be on the “docs.coronalabs.*” scope. For example, this one you found:

http://docs.coronalabs.com/api/library/widget/newScrollView.html

The best way to report issues on these pages, if you find them, is to “rate” them using the 3 buttons at the bottom. For example, on this page you found, there’s a link that leads to an older guide on bitmap masking. If you go to the bottom of the original page and click “Like it, but…” or “Hate it”, and submit a quick reason why, this will bring it to our attention immediately.

Thanks,

Brent