Skip to content

DO NOT MERGE — NPS recovery: 6 new articles + 6 page fixes#1764

Draft
radioblazer wants to merge 2 commits intoMicrosoftDocs:mainfrom
radioblazer:nps-recovery-doc-improvements
Draft

DO NOT MERGE — NPS recovery: 6 new articles + 6 page fixes#1764
radioblazer wants to merge 2 commits intoMicrosoftDocs:mainfrom
radioblazer:nps-recovery-doc-improvements

Conversation

@radioblazer
Copy link
Contributor

DO NOT MERGE — Draft for review

Context

Power Automate OCV NPS is +7.8 vs Power Apps +24.8. Doc analysis (C+E Skilling PBI, 188 pages, 1.6M monthly PV) shows 59% stale, 98% Concepts with almost no troubleshooting content. NPS verbatims: debug 450+, connections 150+, copilot 400+, expressions 245+ mentions.

6 new articles

  • troubleshoot-flow-errors.md — Error resolution landing page
  • fix-connection-failures.md — Connection troubleshooting decision tree
  • error-reference.md — Top 20 error codes with causes and fixes
  • expression-cookbook.md — 30 real-world expression patterns
  • copilot-in-cloud-flows-tips.md — Honest Copilot guidance (what works, what doesn't)
  • classic-vs-modern-designer.md — V1 vs V3 designer comparison

6 existing page fixes (surgical additions, nothing removed)

  • index.yml — Add Troubleshoot + Common Tasks navigation (295K PV, 40% bounce)
  • limits-and-config.md — Scenario-based limit lookup + FAQ (26K PV)
  • ip-address-configuration.md — Scenario lookup + troubleshooting (14K PV)
  • create-team-flows.md — Sharing scenarios + common issues (6K PV)
  • add-manage-connections.md — Troubleshooting section + prevention (5K PV, 33% helpful)
  • change-cloud-flow-owner.md — Transfer walkthrough + checklist (11K PV, 25% helpful)

Evidence

C+E Skilling PBI Content Engagement, AnalyticsHub OCV NPS (8,574 resp/28d), NPS verbatims (14,329 resp/365d), Viva Engage (2,012 posts).

Matt Townsend and others added 2 commits March 19, 2026 10:12
New troubleshooting and reference content targeting top NPS pain points:
- troubleshoot-flow-errors.md: Error resolution landing page (450+ NPS mentions)
- fix-connection-failures.md: Connection troubleshooting decision tree (150+ mentions)
- error-reference.md: Top 20 error codes with causes and fixes
- expression-cookbook.md: 30 real-world expression patterns
- copilot-in-cloud-flows-tips.md: Honest Copilot guidance (what works, what doesn't)
- classic-vs-modern-designer.md: V1 vs V3 designer comparison and migration guide

TOC updated with new articles in Troubleshoot, Copilot, expressions, and designer sections.

Evidence: C+E Skilling PBI shows 59% of PA docs are stale, 98% are Concepts with
almost no troubleshooting content. NPS verbatim analysis: debug 450+, connections
150+, copilot 400+, expressions 245+ mentions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Surgical additions to existing articles targeting pages with worst engagement
signals (PBI Content Engagement data: bounce rate, scroll rate, helpful rating):

- index.yml: Add Common Tasks, Troubleshoot, Licensing nav sections (295K PV, 40% bounce)
- limits-and-config.md: Add scenario-based limit lookup + FAQ (26K PV, 19% bounce)
- ip-address-configuration.md: Add scenario lookup + troubleshooting (14K PV, 23% bounce)
- create-team-flows.md: Add sharing scenarios + common issues (6K PV, 23% bounce)
- add-manage-connections.md: Add troubleshooting section + prevention (5K PV, 33% helpful)
- change-cloud-flow-owner.md: Add transfer walkthrough + checklist (11K PV, 25% helpful)

All existing content preserved. New content uses NOTE/TIP/IMPORTANT callouts.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@prmerger-automator
Copy link

@radioblazer : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. @MatoW, @samathur, @kewaiss

@prmerger-automator
Copy link

@radioblazer : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. @MatoW, @samathur, @kewaiss

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 0812575:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File Status Preview URL Details
articles/index.yml ❌Error Details
articles/error-reference.md ⚠️Warning Details
articles/limits-and-config.md ⚠️Warning Details
articles/copilot-in-cloud-flows-tips.md 💡Suggestion Details

articles/index.yml

  • Line 46, Column 3: [Error: array-length-invalid] Array 'additionalContent.sections' length should be <= 4.
  • Line 48, Column 7: [Error: unknown-field] Could not find member 'additionalContent.sections.linkLists' on object of type 'Array'.
  • Line 65, Column 7: [Error: unknown-field] Could not find member 'additionalContent.sections.linkLists' on object of type 'Array'.
  • Line 88, Column 7: [Error: unknown-field] Could not find member 'additionalContent.sections.linkLists' on object of type 'Array'.

articles/error-reference.md

  • Line 230, Column 135: [Warning: file-not-found - See documentation] Invalid file link: '../power-platform/admin/power-automate-licensing/free-vs-premium.md'.
  • Line 455, Column 73: [Warning: file-not-found - See documentation] Invalid file link: '../power-platform/admin/power-automate-licensing/free-vs-premium.md'.

articles/limits-and-config.md

  • Line 49, Column 23: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#action-request-limits' in 'limits-and-config.md'.

articles/copilot-in-cloud-flows-tips.md

  • Line 0, Column 0: [Suggestion: filename-contains-stop-word - See documentation] Stop words like 'a', 'or', 'and', 'the', and 'in' are discouraged in filenames.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants