tracker issue : CF-3492087

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

Use of deprecated functions in documentation example code

| View in Tracker

Status/Resolution/Reason: Closed/Fixed/

Reporter/Name(from Bugbase): duncan cumming / duncan cumming (duncancumming)

Created: 01/29/2013

Components: Documentation

Versions: 9.0.1

Failure Type: Unspecified

Found In Build/Fixed In Build: 9.0.1 /

Priority/Frequency: Trivial / All users will encounter

Locale/System: English / Windows 7

Vote Count: 0

Problem Description:
The code used to illustrate examples within the CFML documentation sometimes isn't very good.  In fact it even uses deprecated functions.  This increases the chances of developers (particularly those new or less familiar with the language) perpetuating use of these deprecated functions.  Which would be a bad thing.

Steps to Reproduce:
For instance, the documentation for cfdirectory ( http://help.adobe.com/en_US/ColdFusion/9.0/CFMLRef/WSc3ff6d0ea77859461172e0811cbec22c24-7f99.html ) uses GetTemplatePath.  This function has been deprecated since ColdFusion 4.0.  

Actual Result:

Expected Result:

Any Workarounds:

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

Watson Bug ID:	3492087

Deployment Phase:	Release Candidate

External Customer Info:
External Company:  
External Customer Name: duncancumming
External Customer Email:

Attachments:

Comments:

The documentation is being actively cleaned. Many obsolete functions are refactored. For instance, take a look at: https://learn.adobe.com/wiki/display/coldfusionen/cfdirectory The page has now correct examples and also community-contributed snippets. In the case of
Comment by Frank J.
16475 | February 03, 2014 03:44:46 AM GMT
The sample code on that page is *awful*, Frank. Including the community-contributed stuff. Have commented on the page itself.
Comment by External U.
16476 | December 17, 2014 07:02:46 AM GMT