cancel
Showing results for 
Search instead for 
Did you mean: 
Reply
Highlighted
modernoddity
Level: Powered On

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
Super User
Super User

Re: Documentation

@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. Solved your problem? - Click on Accept as Solution. Others seeking the same answers will be happy you did.

View solution in original post

3 REPLIES 3
Super User
Super User

Re: Documentation

@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. Solved your problem? - Click on Accept as Solution. Others seeking the same answers will be happy you did.
modernoddity
Level: Powered On

Re: Documentation

@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. 

Super User
Super User

Re: Documentation

@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. Solved your problem? - Click on Accept as Solution. Others seeking the same answers will be happy you did.

View solution in original post

Helpful resources

Announcements
thirdimage

Power Automate Community User Group Member Badge

Fill out a quick form to claim your user group badge now!

sixthImage

Power Platform World Tour

Find out where you can attend!

Power Platform 2019 release wave 2 plan

Power Platform 2019 release wave 2 plan

Features releasing from October 2019 through March 2020

fifthimage

Microsoft Learn

Learn how to build the business apps that you need.

Top Kudoed Authors (Last 30 Days)
Users online (5,031)