Power Community

Power Community

Options for Documenting Your Power Apps: Comments, Code, and Controls

Within Power Apps there are various ways to document your app. In this post I’m looking at comments in Power Apps

Options to documenting your code in Power Apps

As part of my day job at Vantage 365 I do a lot of health checks of apps and flows. This often means that I’m looking at apps that have been developed by other people. It would be very helpful if apps and flows were documented. In this post I will focus on apps in Power Apps.

There are a few different ways of documenting your apps.

  • Name your screens, controls and variables properly
  • Write a document
  • Comments in code
  • Add Comments to your app

Name your screens, controls and variables properly

Of course we all name our screens, controls and variables properly, so I’m not going to spend any time on that now. The time of c++ in code is something from the past.

Write a Document

You could of course open Word and write a document describing your solution. For Architectural choices made this may be ok, but separating the solution and the documentation isn’t the easiest way to pick up an app. As mentioned I’m used to this, and it takes a bit of training to understand “the why” behind apps that don’t work.

Comments in code

Now in code you can add comments. So for example in the code below there is a comment that explains what a line of code does.

Single line comment in an app

In a similar way you can comment out multiple lines of code or add comments that take take a number of lines. with /* and */

Multiple line comment in Power Apps using /* and */

The above is especially useful to explain to others what your thoughts were when you added that complicated line of code.

Also when you remove a line of code, you could add your initials and a reason for changing the code.

Add Comments to your app controls

Like in Power Automate you can also add comments in Power Apps.

Now if you have recently created a new app you will have noticed these purple boxes popping up on your screens.

Screen templates and comments control in Power Apps

And you might also have noticed them when you add controls like a button:

Comment on a control in Power Apps

Yes, they do get a bit in the way sometimes. But the general idea is nice. You can now add comments in your app related to a control or screen. You can even mention other people in your comments, making it easier for them to find the place where you want them to have a look at a problem that you may be facing.

Power Apps will even help you make sure that you share the app with the users that you mention, if they haven’t got access to the app yet.

Give people mentioned in a comment access to the app.

Now the user mentioned will receive an email as shown below, making it so easy to find the comment inside the app.

Pieter Veenstra mentioned you in a comment

This post was originally published on this site

- Advertisement -spot_img

LEAVE A REPLY

Please enter your comment!
Please enter your name here

- Advertisement - Advertisement

Latest News

5 Benefits of In-App Notifications for Microsoft Dynamics 365 CRM users

For a successful sales process, you need to stay up-to-date with crucial sales information like deal closures, opportunities won,...

More Articles Like This

- Advertisement -spot_img