Skip to main content
This topic has been closed for replies.
Correct answer Charlie Arehart

Saurav, the changes are interesting, and will help many...but there are two ways folks may still easily miss all that the docs (especially the 2000+page Developer Guide) have to offer.

 

First, even following the link you offer for that guide, note that there are no links on the page at all. Just a lot of top level topics. Folks have to notice instead that there is a new widget at the top of the page (on mobile, at least) that offers a full toc for the guide (to at least a couple levels of depth). As an update since I first wrote this, I do see now that on a desktop that widget appears on the left, which is at least more obvious.

 

But second, there's still the problem that some sections are far deeper than they present, and you can be left at a page that tantalizes with possibilities but has only a paragraph or two (yet I know from past experience there are perhaps dozens of pages on that topic).

 

An example is the section on "Integrate JEE and Java elements" (under "Use web elements and external objects"), available directly at:

https://helpx.adobe.com/coldfusion/developing-applications/using-web-elements-and-external-objects/integrating-jee-and-java-elements-in-cfml-applications.html

 

It's literally just a single sentence, but has literally 37 pages of content in that topic we can't see (as you can see in the old CF11 PDF here, with this link right to that "first page" of that section. More on the PDFs in a moment.)

 

Such "desert islands" (as I call them) are part of why so much about cf remains unknown to people, especially those new to it or new to the docs in the past 10 years. It was cf11 (in 2014) that the last pdf of the each of the manuals was offered. (They're still offered for download on a cf page, for those who may find that.)

 

And soon after the Adobe docs system changed (as you know, but I'm letting others here know), and that's when we lost so much of the docs because the new system only supported 3 levels of depth, while the cf docs had always been about 5 levels deep. So the pages ARE on the site if one can find them, but like the above even if you find them Vian searching, they often leave one at a loss to find what's "below" them.

 

Maybe it's time to create some variant of what you've done, so each chapter of the docs is itself another "manual", which can then have the added levels of depth needed.

 

It's just so sad this problem still remains, though it's clear you've made some improvement here and we appreciate that. 

2 replies

Community Manager
May 30, 2024

The user guide has been fixed. Apologies for taking more time than expected. We'd run into some unforeseen issues. We'd broken the main guide into six mini guides, for better naviagtion.

https://helpx.adobe.com/coldfusion/user-guide.html

The one you're looking for is, https://helpx.adobe.com/coldfusion/cfml-tags-functions-reference-user-guide.html

Thanks,

Saurav

Charlie Arehart
Community Expert
Charlie ArehartCommunity ExpertCorrect answer
Community Expert
May 30, 2024

Saurav, the changes are interesting, and will help many...but there are two ways folks may still easily miss all that the docs (especially the 2000+page Developer Guide) have to offer.

 

First, even following the link you offer for that guide, note that there are no links on the page at all. Just a lot of top level topics. Folks have to notice instead that there is a new widget at the top of the page (on mobile, at least) that offers a full toc for the guide (to at least a couple levels of depth). As an update since I first wrote this, I do see now that on a desktop that widget appears on the left, which is at least more obvious.

 

But second, there's still the problem that some sections are far deeper than they present, and you can be left at a page that tantalizes with possibilities but has only a paragraph or two (yet I know from past experience there are perhaps dozens of pages on that topic).

 

An example is the section on "Integrate JEE and Java elements" (under "Use web elements and external objects"), available directly at:

https://helpx.adobe.com/coldfusion/developing-applications/using-web-elements-and-external-objects/integrating-jee-and-java-elements-in-cfml-applications.html

 

It's literally just a single sentence, but has literally 37 pages of content in that topic we can't see (as you can see in the old CF11 PDF here, with this link right to that "first page" of that section. More on the PDFs in a moment.)

 

Such "desert islands" (as I call them) are part of why so much about cf remains unknown to people, especially those new to it or new to the docs in the past 10 years. It was cf11 (in 2014) that the last pdf of the each of the manuals was offered. (They're still offered for download on a cf page, for those who may find that.)

 

And soon after the Adobe docs system changed (as you know, but I'm letting others here know), and that's when we lost so much of the docs because the new system only supported 3 levels of depth, while the cf docs had always been about 5 levels deep. So the pages ARE on the site if one can find them, but like the above even if you find them Vian searching, they often leave one at a loss to find what's "below" them.

 

Maybe it's time to create some variant of what you've done, so each chapter of the docs is itself another "manual", which can then have the added levels of depth needed.

 

It's just so sad this problem still remains, though it's clear you've made some improvement here and we appreciate that. 

/Charlie (troubleshooter, carehart. org)
Charlie Arehart
Community Expert
Community Expert
May 30, 2024

Simon, while I appreciate your marking my reply here as "an answer", it really wasn't so much that as an expansion on Saurav's. 🙂 Still, thanks.

 

That said, I noticed that his FIRST reply (saying the fix WOULD be coming) was also marked as an answer, while is LAST answer (saying your issue was now addressed) was NOT marked as one.

 

I just swapped those (marking the old one NOT as an answer and the NEW one as BEING an answer). I have that authority as a co-moderator of this forum--but I rarely use it, and only when I think it would be something everyone would logically agree to. Anyway, since I was already writing this reply I thought I'd go ahead and mention it. (Sadly, even we moderators can't see WHO marked or unmarked an answer--whether ourselves or someone else, which is another reason I thought it worth explaining the change I made.)

 

In any case, I do look forward to any thoughts Saurav may have, in reply to my comment. That said, I realize he is responsible for the docs for MANY different Adobe prodcuts, not just CF, so I understand if it may take him time to be able to offer any reply.

/Charlie (troubleshooter, carehart. org)
Community Manager
May 11, 2024

We are working on it. There is some AEM issue we are resolving. Should be up and running in 2-3 days.

Legend
May 21, 2024

Well, it's been 10 days since your post and I don't see it.  Why on earth would you remove the previous guide?