foundeo / cfdocs Goto Github PK

http://cfdocs.org/reports/todo.cfm that is
If I understand correctly what 'implement' means on this page, reads to me like "not documented here yet" (<a href="adobe....." to help)

For example http://cfdocs.org/decision-functions having "requist"

Needs examples resize would be a good first example.
Needs min_version:8
Missing Attribute: interpolation CF10+ applies to action = "resize"

A page describing Coldfusion's server CGI variables is missing. I was going to create it, but I'm not sure where the best location is and what format it should be. I thought maybe it should go under Guides, but the files in guides/en don't follow the same structure as the files in data/en. This would be tabular data mostly.

The content would of course start with the Adobe reference: https://helpx.adobe.com/coldfusion/cfml-reference/reserved-words-and-variables/cgi-environment-cgi-scope-variables/cgi-server-variables.html

But that page is missing some variables, most relevant to me right now is "LOCAL_ADDR". It would be great to add more of these undocumented CGI variables.

Another thought, instead of a CGI-only page, should this go in a "Scopes" page? This would have CGI, client, server, application, session, and perhaps some others.

Just trying this tag for the first time in a trial version of CF 11. I'm unable to pass any URL vars with the source without error, for both .cfm and .html pages. For example, source="myPage.html" works as expected, but source="myPage.html?x=1" throws a 500 error.

When the urltoken is not passed with the source when the source is a .cfm page, the session (login) is not recognized and we get thrown to the login page.

https://github.com/foundeo/cfdocs/blob/master/data/en/arrayfindnocase.json#L7

Note that the description includes a note about the returned index being 0 if not found. This note is not visible at: http://cfdocs.org/arrayfindnocase

Taking this issue.

Need to add the following attributes: rest, restPath, httpMethod, produces, consumes, indexable, indexLanguage, autoIndex, wsVersion

I see you've got the data under an 'en' directory. Are you setup already to support multiple languages? If so I think Team CF Advance could gather some devs from Brazil, at least, to work on a secondary language. Thoughts?

http://cfdocs.org/cfparam

https://learn.adobe.com/wiki/display/coldfusionen/Invoke

Making note of this for later as I don't have time to fix at the moment.

http://cfdocs.org/arrayisdefined returns CF error:
"Element REQUIRED is undefined in P."

Need a plan of attack for how best to display version specific syntax, attributes, etc.
CF11/Railo and beyond will most likely enhance tags/functions that will either break or silently ignore.

We could:

• display version support by tabs or pillboxes (All Latest ACF Railo OpenBD)
• add extra column/field for version support since (paramSupportedSince...)
• or just not worry about it. Let developer deal with it.

⭐
I have updates for the CFDoc JSON Builder to be able to load a tag/function json and edit.

https://wikidocs.adobe.com/wiki/display/coldfusionen/FileUpload

https://wikidocs.adobe.com/wiki/display/coldfusionen/FileUploadAll

It would be great to include example code for each function. ACF docs are notoriously bad at examples and cfdocs could really fill that void for the community.

Add a doc on the best ways to integrate with the underlying Java engine, the best features to integrate with, when to drop into java, how to know CF dropped into java, and more. This would be very beneficial to users that might not find a feature in CF but know Java has it.

Need a pretty print for json output for browser or file write so Pete doesn't have to reformat changes/additions to json.

😄

Missing the CF11+ attribute autosize.
Missing min_version = 9
The excludeHeaderRow attribute description start with CF9.0.1+
Add an Example reading and writing a spreadsheet.

It is missing the new attributes added in CF11.

It could also use an example showing how to send using a query.

PR incoming.

Example on this page http://cfdocs.org/lsiscurrency. Its not 100% clear on first glance if the function is called isLsCurrency or LsisCurrency.

I do get though that this is a generall issue with a lot of fonts.

On http://cfdocs.org/string-functions for example the list is shorter than on other pages

ACF and lucee both take an optional third argument for data.

We'd have to contact the fellow who runs trycf.com, but it would be cool if we could define a new item in our json object like: "example_gist":"gist url here" and either have the ScratchPad load the gist in cfdocs or at least link to trycf.com and load the gist content there.

The latter could be implemented very easily I think since he's already allowing users to load a gist on trycf.com. The former would be super convenient.

Probably want to store these gists in a central account so none go missing.

As discovered by Alexander Kwaschny in https://bugbase.adobe.com/index.cfm?event=bug&id=4105828 uppercase "Y" is different from lowercase "y" the Adobe docs don't mention this explicitly but they do say that the function also follows Java date time mask. Unfortunately they link to a java 6 doc where uppercase "Y" wasn't used yet.

On /reports/todo.cfm the word "now" in the sentence "Look for missing examples now." links to the now() function page.

As posted to Slack by @brandner:

Documentation for CFFTP attribute 'systemtype' should be added (ACF at least). Just spent an hour on that rabbit hole. As per Pavan Kumar - http://cfpavankumar.blogspot.ca/2015/07/cfftp-listdir-fails-when-syst-command.html