cancel
Showing results for 
Search instead for 
Did you mean: 
Reply
modernoddity
Helper III
Helper III

Documentation

Just curious what everyone uses to document their PowerApps creations. Currently using Evernote but looking for a better solution. 

1 ACCEPTED SOLUTION

Accepted Solutions

@modernoddity 

I'll make one desing suggestion at least...

Consider having a separate screen that is really only for design and development - no user would ever need to see it.

On there consider using labels and other types of controls in place of variables in your app.

Very often I see people put in formula to (for example) calculate a value.  It might be a complex formula.  And they will hunt around for where to put it...on a button, on a screen visible, on some other action.  Then they will set the variable and use it in a label with the text property being the variable.

My suggestion is...create a label on the dev screen and put the complex formula in the text property directly.  Then in your app, refer to that label.text anytime you want the value...instead of a variable. 

The advantage?  One, your complex formula is now in an EASY place for someone to find it if they need to adjust it.  It's very hard to find Set formulas that may be in some action.  Two, you are reducing the number of variables that your app has to deal with.  Three, it's much easier to troubleshoot any issues directly in that control.

 

Anyway...just another $0.02  But it really helps!

 

_____________________________________________________________________________________
Digging it? - Click on the Thumbs Up below. Solved your problem? - Click on Accept as Solution below. Others seeking the same answers will be happy you did.
NOTE: My normal response times will be Mon to Fri from 1 PM to 10 PM UTC (and lots of other times too!)
Check out my PowerApps Videos too! And, follow me on Twitter @RandyHayes

Really want to show your appreciation? Buy Me A Cup Of Coffee!

View solution in original post

3 REPLIES 3
RandyHayes
Super User
Super User

@modernoddity 

Besides in-line commenting and comment/doc screens, I've also put OneNote to play for PowerApps documentation as there is a connector for it.  Makes it easy to throw a doc screen in to doc as you go along and have the App put it in OneNote.  Not so good for displaying the notes as the OneNote connector is broken when using the GetPageContent function (for a loooong time!!!)...but at least you can create the notes.

But, overall, it really depends based on what kind of documentation you are creating.  Design docs or user docs? In some cases either tool will be comparable. 

 

$0.02 applied.

_____________________________________________________________________________________
Digging it? - Click on the Thumbs Up below. Solved your problem? - Click on Accept as Solution below. Others seeking the same answers will be happy you did.
NOTE: My normal response times will be Mon to Fri from 1 PM to 10 PM UTC (and lots of other times too!)
Check out my PowerApps Videos too! And, follow me on Twitter @RandyHayes

Really want to show your appreciation? Buy Me A Cup Of Coffee!
modernoddity
Helper III
Helper III

@RandyHayes 

 

Thanks! This is primarily for design docs. I want to make sure my coworkers have all the documentation I can provide so if I ever leave, they have something to fall back on when it comes to supporting the app. 

@modernoddity 

I'll make one desing suggestion at least...

Consider having a separate screen that is really only for design and development - no user would ever need to see it.

On there consider using labels and other types of controls in place of variables in your app.

Very often I see people put in formula to (for example) calculate a value.  It might be a complex formula.  And they will hunt around for where to put it...on a button, on a screen visible, on some other action.  Then they will set the variable and use it in a label with the text property being the variable.

My suggestion is...create a label on the dev screen and put the complex formula in the text property directly.  Then in your app, refer to that label.text anytime you want the value...instead of a variable. 

The advantage?  One, your complex formula is now in an EASY place for someone to find it if they need to adjust it.  It's very hard to find Set formulas that may be in some action.  Two, you are reducing the number of variables that your app has to deal with.  Three, it's much easier to troubleshoot any issues directly in that control.

 

Anyway...just another $0.02  But it really helps!

 

_____________________________________________________________________________________
Digging it? - Click on the Thumbs Up below. Solved your problem? - Click on Accept as Solution below. Others seeking the same answers will be happy you did.
NOTE: My normal response times will be Mon to Fri from 1 PM to 10 PM UTC (and lots of other times too!)
Check out my PowerApps Videos too! And, follow me on Twitter @RandyHayes

Really want to show your appreciation? Buy Me A Cup Of Coffee!

Helpful resources

Announcements
Power Platform Conf 2022 768x460.jpg

Join us for Microsoft Power Platform Conference

The first Microsoft-sponsored Power Platform Conference is coming in September. 100+ speakers, 150+ sessions, and what's new and next for Power Platform.

Carousel_PP_768x460_Wave2 (1).png

2022 Release Wave 2 Plan

Power Platform release plan for the 2022 release wave 2 describes all new features releasing from October 2022 through March 2023.

365 EduCon 768x460.png

Microsoft 365 EduCon

Join us for two optional days of workshops and a 3-day conference, you can choose from over 130 sessions in multiple tracks and 25 workshops.

Top Solution Authors
Users online (4,878)