How would that work? Let's day I have a action CreateOrUpdateOrder. What description should be generated? What would we already not understand what the action is about?

Yes, your point is right. Like for example if I have a server action FetchEmployeeDeptCount. Yes, I know it’s fetching employee count data department wise. But it would be good if you had a description with the action instead of guessing what the action is. Sometime there can 100+ server actions and some of them can have similar names instead of creating confusion and going through full logic, descriptions are there to clarify what action it is and what it’s use for.

But how could OutSystems automatically generate descriptions to avoid that confusion? 

Using AI it can analyze the logic action flow and then can create a description. Like - if a flow has excel to record list and then for each to list append, On basis of this creating a description that  this action get a excel list as input then pass it to excel to record list then append the list using for each. I know it would big task but just like we have a suggestion in action when we drag arrow and get suggestion, like that if we can get a suggestion for description.

Maybe, but what I see with current state of AI, it can only suggest, the developer needs to review. I really don't want to review a description on an action that is clearly understandable by its name. Danger is we end op with a wrong document all over the place, probably worse than having no documentation.

Yes, you are right but if there is an option to suggest also it would be good. If only developer want it to be on then only it will suggest.