Hey everyone! We just started rolling out the ability to add descriptions to expressions. Weโre starting with just slice filters, but we plan to expand the supported locations in the editor as we develop the feature.
As the rollout progresses and youโre able to try it out, we would love to hear your feedback and thoughts in this thread!
Note: If youโve opted in early to the โUse words to create expressionsโ feature, the โdescriptionsโ feature is already available to you.
FAQ
Why add this โdescriptionsโ feature?
Whatโs the difference between this and the โDescriptive commentโ field for the slice?
I realize this can be confusing, so any feedback on ways to disambiguate these fields is appreciated.
If Iโm not interested, how do I opt-out?
For now, opt-out is not available for self-service and must be done manually, so to do that, you can send me a PM with your account ID. I will add a self-service option in due time.
Hey @natalie , thanks for the update! This is definitely better than having no comments at all, and seems like a good alternative to completely rebuilding the expression engine to support true //comment lines
. Iโd prefer to be able to insert comment lines anywhere in the expression, but I realize what a massive overhaul that would require.
Would it be possible to select both in an array when copying, and then parse them back into separate descriptions & expressions when copying/pasting between columns? That way, even though they โliveโ in different fields of the editor, they could be easily ported from one column to another and โtravel togetherโ to save us an extra round of copy/paste.
This is great! Iโm especially excited to see this feature attached to all expressions.
I wonโt use them but I think itโs great that others have the option.
The only thing I ask is that example descriptions are not automatically inserted like they are for โRelatedโ Virtual Columns. It is tedious to remove them. Why do I remove them? Text is one of the slowest things to load/transmit - even when loading the app in the editor. I donโt need the descriptions and comments so I remove as much of them as I can to help with app load time. Does it make a huge difference? Maybe not but I try to give myself every edge that I can as I work in several apps every day.
By the way, descriptions and comments are only good if they are kept up to date. If you use them, be diligent in keeping them updated - otherwise they are worthless.
Let me be happy even though I know 2 changes later on my formulas Iโm not gonna remember to update the description
By the way, descriptions and comments are only good if they are kept up to date. If you use them, be diligent in keeping them updated - otherwise they are worthless.
Many of us like to follow the โGood Practiceโ even though it makes our lives harder. There is a certain sense of satisfaction when you reach that 100% test coverage, or document your code thoroughly.
This is amazing feature, specially because itโs not at all easy to understand and existing AppSheet app; as it is 2 steps removed from the reasoning. Itโs much easier if you can have the source code due to IDEโs code analysis tools.
Iโve loved to use the documentation section for every table, view, slice I created. I always wondered how/who/where you can read all these docs, still I did my duty for myself.
use these descriptions as training data for machine learning
Super cool! I think this is a really savvy feature
This is VITAL and I am urgently needing this to be implemented everywhere in appsheet. Iโve built our entire organisation on a single Appsheet app. Starting 4 years ago when it was just me. Now thereโs over 70 users. We have developers seeking to refactor the app. The lack of commenting on expressions has been a massive problem. Thanks for rolling this out urgently.
Will the text of the description be included in the โapplication documentationโ that is created for each app?
I find it convenient to search the text of this document to find thing in my rather large app. I hope the text is included.
Thanks everyone for the responses! Iโve answered them below. Apologies for the delay.
Would it be possible to select both in an array when copying, and then parse them back into separate descriptions & expressions when copying/pasting between columns? That way, even though they โliveโ in different fields of the editor, they could be easily ported from one column to another and โtravel togetherโ to save us an extra round of copy/paste.
Thanks for sharing that feedback. It is not possible, but Iโve added this request to our internal tracking system for further consideration.
The only thing I ask is that example descriptions are not automatically inserted like they are for โRelatedโ Virtual Columns.
If the expression was authored using your own words (via the feature in Use words to create slice filter expressions), the Expression Assistant will use the words used to โsearchโ the suggestions as the default description. This behavior is shown below:
Otherwise, we do not automatically insert descriptions.
By the way, descriptions and comments are only good if they are kept up to date. If you use them, be diligent in keeping them updated - otherwise they are worthless.
Good point, Iโve added this to our internal tracking system as something we could try to solve โ possibly by introducing some visual indication that the description is โstaleโ with respect to the expression.
Will the text of the description be included in the โapplication documentationโ that is created for each app?
It isnโt currently supported, but I agree we should โ added this request to our internal tracking system.
Good point, Iโve added this to our internal tracking system as something we could try to solve
Hi Natalie, while this comment was mainly aimed at the community who wanted the ability to notate their expressions, I suppose it also applies to us all for anything we do.