Highlighted

Acrobat documentation: dead and foul links everywhere

Community Beginner ,
Nov 18, 2020

Copy link to clipboard

Copied

As a frequent user of the acrobat documentation, I run into dead and non-functional links everywhere.

Without my bookmarks, I would have to give up if I was just relying on Google. Some highly indexed pages on Adobe docs have become useless.

 

Some starters for badly maintained documentation:

https://www.adobe.io/apis/documentcloud/acrobat/docs.html

  • Individual section links under headings are just one block-link to the last section (e.g. all links under “Javascript for Acrobat” link to “Batch Sequences”)

 

https://www.adobe.com/devnet/acrobat/javascript.html

 

It would be really helpful to developers if Adobe could clear up these pages.

 

The documentation website also has a contact page on https://www.adobe.io/contactus.html, but -- sure enough -- the contact email (dl-io-website-help@adobe.com) bounces back as well...

TOPICS
Acrobat SDK and JavaScript, How to

Views

51

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more

Acrobat documentation: dead and foul links everywhere

Community Beginner ,
Nov 18, 2020

Copy link to clipboard

Copied

As a frequent user of the acrobat documentation, I run into dead and non-functional links everywhere.

Without my bookmarks, I would have to give up if I was just relying on Google. Some highly indexed pages on Adobe docs have become useless.

 

Some starters for badly maintained documentation:

https://www.adobe.io/apis/documentcloud/acrobat/docs.html

  • Individual section links under headings are just one block-link to the last section (e.g. all links under “Javascript for Acrobat” link to “Batch Sequences”)

 

https://www.adobe.com/devnet/acrobat/javascript.html

 

It would be really helpful to developers if Adobe could clear up these pages.

 

The documentation website also has a contact page on https://www.adobe.io/contactus.html, but -- sure enough -- the contact email (dl-io-website-help@adobe.com) bounces back as well...

TOPICS
Acrobat SDK and JavaScript, How to

Views

52

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Nov 18, 2020 1
Most Valuable Participant ,
Nov 18, 2020

Copy link to clipboard

Copied

Suggest you download the SDK and use it locally. Less subject to webmaster's carelessness.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 18, 2020 0
Community Beginner ,
Nov 18, 2020

Copy link to clipboard

Copied

True, but everytime I have to access the documentation from mobile or a different user's PC, I google it and end up on those sucker pages that link nowhere or on the pdf of the 2006 standard.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 18, 2020 0
Adobe Community Professional ,
Nov 18, 2020

Copy link to clipboard

Copied

Info: Acrobat 9 is old and unsupported.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 18, 2020 0
Community Beginner ,
Nov 18, 2020

Copy link to clipboard

Copied

So? How is this relevant?

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 18, 2020 0
Most Valuable Participant ,
Nov 18, 2020

Copy link to clipboard

Copied

Because you're trying links to the Acrobat 9 SDK. Why would Adobe keep offering the SDK for an unsupported product? That will encourage development for old versions, the exact opposite of what is good for their profits.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 18, 2020 0
Community Beginner ,
Nov 19, 2020

Copy link to clipboard

Copied

Ok, I think you're wilfully trying to not understand this problem, and/or are defending Adobe's bad practices (or rather negligent non-practices) by reflex. Nevertheless, I'll try to explain my point more clearly.

 

The problem I have is clearly not with Adobe not keeping the Adobe 9 SDK online. Although, come to speak of it, every serious software company will try to keep SDKs for older versions online. Adobe itself clearly does not follow your line of thought, since the PDF versions of the older SDKs are still readily available and extremely prominent when you search for information with Google. What I would expect with regard to the link to version 9 of the SDK is either that it continues to be available under the URL where it has been located for years, possibly with a warning on the page that this is the outdated version of the SDK, or that it leads you to the current version of the SDK. This would be good practice; it's not asking for too much from Adobe to do this. Do you know, e.g. how many Stackoverflow-Answers link to version 9 of the SDK (all 404 now).

 

But the real problem is not the link to version 9 of the SDK. The problem is that some of the most promiment documentation pages from Adobe itself link to this non-existent version, but not the current SDK. https://www.adobe.com/devnet/acrobat/javascript.html should be a central entry point for these resources, it is linked to from hundreds of forum entries because it used to be the starting point for the SDK. Nowadays the page is still up, but not up to date. There is no link to current resources, the link to version 9 of the SDK is incorrectly filed under a heading to version X and the only docs available on this page are to version 8 of the SDK and 13 years old!

 

This page is entry 5 when I google "Acrobat JavaScript API" (keeping in mind that Google personalises results by region and person, this may be different for you). Every entry before it is even more useless, either the PDFs of the older SDKs or the mobile API reference (that is only relevant for reader, not for pro). It is followed in the Google search by prominent forum entries, such  as this one: https://answers.acrobatusers.com/JS-API-Reference-q112190.aspx Where does the answer on the old adobe community lead to? Sure enough the non functional site above. Notice a pattern? It's really difficult to find the relevant information because Adobe does not keep these pages up to date.

 

The two pages with the current documentation are:

https://www.adobe.io/apis/documentcloud/acrobat/docs.html

https://www.adobe.com/devnet/acrobat/documentation.html

On Google I can only reach these if I click on "show further results form adobe.com", when they appear on page 2 of the results. Moreover, the first of these is full of mistakenly formatted links so that it does not lead users to the place they clicked. Again, Adobe should fix this.

 

And lastly, the adobe.io Website has a contact form, but again the contact email does not work.

 

Adobe should fix this. They should also improve their SEO so that their current documentation can be easily found, especially when users are lead to the older documentation that is heavily referenced all over the web.

 

The current state of theses sites is frustrating and annoying, and I'm actually trying to be helpful by pointing this out to Adobe on the only place where this is possible - this forum - since Adobe actively refuses to be contacted anywhere more directly.

/*RANT*/What is even more annoying and frustrating, though? Pointing these errors in the documentation out, and then to receive a one-line non-sequitur answer from a really prolific and highly prominent community user who does not read the initial question, tries to disavow that these errors exist and thereby shuts down the discussion before anyone who can actually make the changes on the website notices/*RANT OVER*/

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 19, 2020 0
Adobe Community Professional ,
Nov 19, 2020

Copy link to clipboard

Copied

For me the real problem is that in the documentation available in 2020 there are passages that have not been updated for more than 20 years !!!

 

There are still passages where it talks about Mac OS 9 (before Mac OS X) and its limitations.

Especially with regard to TTS methods.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 19, 2020 1