Comments (8)
My thought was to keep it simple initially. So ideally if there are any compatibility differences those should be put in the notes field under each engine. If that doesn't end up work well, then we could add a compatibility column to the params struct, but I'd like to avoid that until it seams necessary.
from cfdocs.
The more I think about this, it might be a good idea to have support in the params for compatibility info -- I am thinking something like this:
params: [ { compatibility: { engine: "coldfusion", version: "11", notes: "Added this attribute" }, ... } ]
What do you think.
from cfdocs.
looks good. So dropping the min version in the primary attribute of a parameter and utilizing the version inside the compatibility key?
from cfdocs.
Was there a min version attribute in params? If so I don't know if it was used anywhere.
There is a minimum_version in the engines key -- which I think I'd like to keep that because I am using that to show the version number in the anchor text to the official docs on the top right.
from cfdocs.
You're right i don't think there was a min version params. I was thinking about engine.
from cfdocs.
Just as a short addition: Adobe has a history for each tag with all attribute-changes in their documentation (e.g. Coldfusion 9 - cfdump) but i like your suggestion and think, it would be more flexible. As a next step you could summarize all changes of all attributes and display them in as well in the end.
might be that it would be useful to know, when the tag was added to the language (the min-version), but as showed in cfdump, some attributes were added or changed later, so it would be nice, if that was also visible.
from cfdocs.
Sihu - there is the ability to specify what version that the tag was added under the engines key, see example here for a function that was added in cf10 and railo 4: https://github.com/foundeo/cfdocs/blob/master/data/en/sessionrotate.json then when you look at the doc page it shows R4+ and CF10+ on the top right, and links to their respective documentation. Under the engine key you can also specify notes which list any compatibility notes for a specific engine, you could use this to list history of new attributes but I think adding it to the params is going to be a better more structured approach in general, but since we don't support that yet if you want to add something to the notes or the description of the param feel free.
from cfdocs.
I'm going to close this, I think we can simply add CF9+ in the param description if necessary, I don't want to make it too complicated.
from cfdocs.
Related Issues (20)
- Auto Link Should Ignore HOT 5
- Missing Lucee's IsInThread method HOT 2
- Broken link last line in README for `http://cfeclipse.org/` HOT 1
- GenerateSecretKey does not support algorithm CFMX_COMPAT as CFDocs write HOT 1
- fileExists function requires absolute path to be specified
- Formatting Functions
- Security Functions
- cfchart HOT 2
- cfschedule HOT 9
- Add Example pop-up page - update instructions
- Decision Functions - not synced with github HOT 2
- Add description for `isolation` values in `cftransaction`
- replaceNoCase HOT 2
- cflayout
- binaryEncode
- isValid HOT 4
- structKeyExists HOT 1
- cfcatch variables
- Missing 'GetSystemSetting' function HOT 2
- AS of CF2021 cfquery accepts a returnType option
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from cfdocs.