cancel
Showing results for 
Search instead for 
Did you mean: 
Reply
Highlighted
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
Highlighted
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
Highlighted
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.
Highlighted
Helper III
Helper III

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. 

Highlighted
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
Check this Out

Helpful information

Featuring samples like Return to the Workplace and Emergency Response Applications

August 2020 Community Challenge: Can You Solve These?

August 2020 Community Challenge: Can You Solve These?

We're excited to announce our first cross-community 'Can You Solve These?' challenge!

secondImage

Return to Workplace

Reopen responsibly, monitor intelligently, and protect continuously with solutions for a safer work environment.

secondImage

Super Users Coming in August

We are excited for the next Super User season.

secondImage

Power Platform 2020 release wave 2 plan

Features releasing from October 2020 through March 2021

Top Solution Authors
Top Kudoed Authors
Users online (5,368)