tracker issue : CF-4160535

select a category, or use search below
(searches all categories and all time range)
Title:

Please, please add a "next/previous" page link/icon (and subsection links) in the online version of the CF 2016 docs

| View in Tracker

Status/Resolution/Reason: Closed/Fixed/HaveNewInfo

Reporter/Name(from Bugbase): Charlie Arehart / Charlie Arehart (Charlie Arehart)

Created: 06/02/2016

Components: Documentation

Versions: 2016

Failure Type:

Found In Build/Fixed In Build: CF2016_Update1 / docs

Priority/Frequency: Major / All users will encounter

Locale/System: English / Win 2008 Server R2

Vote Count: 1

Following on to the bug about problems with the PDF version of the docs (4155931), but separate as I'm now referring to the online/HTML version of the docs:

1) Could someone also please, please add back (in the online docs) the icon/link to go from page to page within the docs? 

Especially in all the docs but the CFML Reference, it's typical for a topic to be spread over many "pages" of subtopics and/or sibling/related topics within a chapter. But there's now no link, like there was in the CF10 version of the docs.

Consider, for example, the "introduction" page on ORM at:

https://helpx.adobe.com/coldfusion/developing-applications/coldfusion-orm.html

An uninformed reader may come away thinking that that's all that there is on the topic, when in fact there are over 120 pages of content on the topic (as viewed in the PDF version for CF11).

Compare that to the CF10 version of the online docs (can't seem to find the CF11 online docs anymore):

http://help.adobe.com/en_US/ColdFusion/10.0/Developing/WSD628ADC4-A5F7-4079-99E0-FD725BE9B4BD.html 

Note how there is not only the next/previous page icon in the top right, which is so desperately missed!

2) But also note that the CF10 version of the page shows the subtopics within that chapter, whereas the CF2016 version of the docs does not. Again, it leaves the reader (in the 2016 version) to further think that there is no more on the topic than what is on this page. That, too, is a tragic loss of info and context, and only further contributes to the challenge of people using CF most effectively.

3) Separately, but not preferable over the two above, it would also be nice also to have a "table of contents" feature on the left of all the doc pages, as there has been at times in the history of the docs.

4) Please also consider more effective breadcrumbs at the top of each docs page, to help one know what manual, chapter, section, and subsection they may be in.

All these are very important factors in effectively using the CF docs, again especially in any of the several manuals other than the CFML Reference (which does tend to have all info on a single page). The fact that so many use only the CFML Reference is bad enough. Now when we may get them to consider the other docs, they need to be easily used!

----------------------------- Additional Watson Details -----------------------------

Watson Bug ID:	4160535

External Customer Info:
External Company:  
External Customer Name: Charlie Arehart
External Customer Email:  
External Test Config: N/A

Attachments:

Comments:

What is absolutely necessary on your Mobile Application Development (as well as every other doc) is to have peer navigation so that the user can get to and from each page, as well as back to the Table of Contents. The user would never know that what they're reading is but one in a series of many mobile articles if they found that one page on Google. Over the course of the past several months, I've seen one, maybe two of these articles in trying to figure out if ColdFusion's version of Mobile Application Development is right for us, but had no idea that they were part of a larger set of tutorials. This resulted in our exploration of other mobile app solutions. Check out this page as an example: https://helpx.adobe.com/coldfusion/mobile-application-development/packaging-mobile-applications.html Can you find any place where the main page (https://helpx.adobe.com/coldfusion/mobile-application-development.html) is linked to or referenced? How would one know, upon Googling an(TRUNCATED)
Vote by External U.
2512 | August 10, 2016 07:44:48 AM GMT
Why is this marked fixed? It's not fixed! And see the voter comment on the right, for another exmple that makes the point.
Comment by Charlie A.
30139 | January 23, 2019 10:32:21 PM GMT