Coder Social home page Coder Social logo

Comments (8)

pfreitag avatar pfreitag commented on June 21, 2024

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.

pfreitag avatar pfreitag commented on June 21, 2024

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.

melinite avatar melinite commented on June 21, 2024

looks good. So dropping the min version in the primary attribute of a parameter and utilizing the version inside the compatibility key?

from cfdocs.

pfreitag avatar pfreitag commented on June 21, 2024

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.

melinite avatar melinite commented on June 21, 2024

You're right i don't think there was a min version params. I was thinking about engine.

from cfdocs.

sihu avatar sihu commented on June 21, 2024

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.

pfreitag avatar pfreitag commented on June 21, 2024

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.

pfreitag avatar pfreitag commented on June 21, 2024

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)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.