Wishlist - A one pager changelog for each CF versi...
# adobe
j
Wishlist - A one pager changelog for each CF version. Digging back through each update / release to see when feature "X" was added is a pain.
2
m
Out of curiosity, what would be the benefit? We are at a 2 versions non-eol at the moment. No one should be using non-eol versions of CF. Is this just for a research project or something? Also could you point me to something like this for C# or Python or PHP so we would have a template to go off of?
r
I no longer have a use case for this, but it would have been handy when we had CF 10, 2016, and 2021 in production at the same time and the development machines were 2021.
Each function lists the versions supported when you click on the function. Also, please note how much faster the PHP documentation website is. It's a chore slogging through Adobe's CF documentation, which is why I always use cfdocs.org first.
👍 1
m
So would you be most interested in language features? The thing with CF is that we add all kinds of things to the ecosystem. Not just new functions. I'm not saying this would be a bad thing to have, it would just be an absolutely huge beast to handle depending how far back you went.
r
Yes. In my previous use case developers were using new CF 2016 and 2021 language features (new member functions) but then deploying to CF 10 where they didn't work. We've changed our development setups and deployment processes, but better CF documentation wouldn't hurt.
j
I'm not sure of the benefit of going backwards but moving forward this would be a great opportunity to start this. For examples you can look at almost any project on github, click Releases and see a nice list. https://go.dev/doc/devel/release https://github.com/rust-lang/rust/releases Versions are mentioned in docs: https://doc.rust-lang.org/std/collections/hash_map/struct.IntoKeys.html https://docs.python.org/3/whatsnew/changelog.html I also don't think you need to get too deep in the weeds but if a feature or function is newly added/change/removed - it would be helpful to know when, and what version. Or a function changed significantly like the date format D mask. Even with just 2021 and 2023 - when I look at the user guide - what versions does it cover? Is it just 2023? Both? https://helpx.adobe.com/coldfusion/user-guide.html
m
Ah ok, I see your point Jim, and its a good one. We sort of do this, but not in a way that is easy to find. https://helpx.adobe.com/coldfusion/using/whats-new.html (has the newest features for the newest build, in this case CF23) https://helpx.adobe.com/coldfusion/using/whats-new-coldfusion-2021.html (Has the new released features for CF21) Hey @saghosh & @Charvi what would you guys think about having a "features by release" page or section where we would list out the stuff that had come out for a particular release, the way we do for CF21? Maybe link to that page from the user guide?
c
@Mark Takata (Adobe) - noted. we are working on a new home page which will have some quick links to the more important documentation pages. will add this to the list.
❤️ 2