tracker issue : CF-4119993

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

The docs for querysort are useless

| View in Tracker

Status/Resolution/Reason: Closed/Fixed/

Reporter/Name(from Bugbase): Adam Cameron / Adam Cameron (Adam Cameron)

Created: 02/19/2016

Components: Documentation

Versions: 2016

Failure Type: Usability Issue

Found In Build/Fixed In Build: CF2016_Final /

Priority/Frequency: Normal / Most users will encounter

Locale/System: ALL / Platforms All

Vote Count: 3

Listed in the version 2016.0.02.299200 Issues Fixed doc
https://helpx.adobe.com/coldfusion/cfml-reference/coldfusion-functions/functions-m-r/querysort.html

There's no example, there's no definition of what the callback function signature is.

They are just completely unhelpful

Also no history, category or see also sections.

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

Watson Bug ID:	4119993

External Customer Info:
External Company:  
External Customer Name: Adam Cameron
External Customer Email:  
External Test Config: My Hardware and Environment details:

Attachments:

Comments:

Having an example of the proper function signature is extremely important. Due to CF's automatic conversion of data types, implementing the wrong logic rarely causes a hard error. The function simply won't work correctly and there is absolutely no indication to the developer *why* it does not work as expected - or how to fix it.
Vote by External U.
4565 | February 19, 2016 02:54:14 PM GMT
Yes. Docs needs an improvement.
Vote by External U.
4566 | February 22, 2016 03:12:51 AM GMT
test note
Comment by CFwatson U.
4563 | June 07, 2016 04:19:14 AM GMT
The fix for this bug is available as part of the early-access build for ColdFusion 2016 Update 2.
Comment by CFwatson U.
4564 | June 07, 2016 04:26:07 AM GMT