Update visitor tracker coverage and contribution guidance

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,5 +1,5 @@
-> We're so eager to add your sample to this repository as soon as possible, but we need all samples follow the same structure. 
-> To make sure we process it as soon as possible, make sure to follow [these instructions](https://github.com/pnp/powerapps-samples/wiki/How-to-submit-a-Power-App-sample).
+> Thank you for improving an existing sample or the documentation in this repository.
+> Before submitting, follow the [contribution guidance](../CONTRIBUTING.md). Submit new samples to the [Power Platform Samples repository](https://github.com/pnp/powerplatform-samples).
 
 |        Q        |                    A                    |
 | --------------- | --------------------------------------- |
@@ -19,6 +19,11 @@
 | Solution uses custom connectors?                          | no - yes?                               |
 | Layout                                                    | Phone? Tablet? Other?                               |
 
+For sample changes, confirm that:
+
+- The sample-root `README.md` is based on the repository template and ends with the required visitor tracker using the sample folder's repository-relative path.
+- `assets/sample.json` remains synchronized with README names, descriptions, authors, links, and other catalog details when applicable.
+
 ## What's in this Pull Request?
 
 > Please describe the changes in this PR. Sample description or details around bugs which are being fixed.
@@ -38,4 +43,3 @@
 > *Remember that this repository is maintained by community members who volunteer their time to help. Be courteous and patient.*
 > _(DELETE THIS SECTION AFTER READING)_
 
-

CODE_OF_CONDUCT.md

@@ -6,4 +6,4 @@ For more information, see the [Code of Conduct FAQ](https://opensource.microsoft
 
 Remember that this repository is maintained by community members who volunteer their time to help. Be courteous and patient.
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/CODE_OF_CONDUCT.md" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/CODE_OF_CONDUCT.md" />

CONTRIBUTING.md

@@ -2,6 +2,8 @@
 
 If you'd like to contribute to this repository, please read the following guidelines. Contributors are more than welcome to share their learnings with others in this centralized location.
 
+New samples should be submitted to the [Power Platform Samples repository](https://github.com/pnp/powerplatform-samples). This repository continues to accept fixes and improvements to its existing samples and documentation.
+
 ## Code of Conduct
 
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
@@ -24,30 +26,43 @@ Whenever you are submitting any changes to the PnP repositories, please follow t
 * If you are submitting multiple samples, please create a specific PR for each of them
 * If you are submitting typo or documentation fix, you can combine modifications to single PR where suitable
 
-## Sample Naming and Structure Guidelines
+## Sample README and Metadata Guidelines
 
-When you are submitting a new sample, it has to follow up below guidelines
+When you update a sample in this repository, follow these guidelines:
 
-* You will need to have a `README.md` file for your contribution, which is based on [the provided template](/samples/README-template.md) under the `samples` folder. Please copy this template to your project and update it accordingly. Your `README.md` must be named exactly `README.md` -- with capital letters -- as this is the information we use to make your sample public.
+* The sample-root `README.md` is the README directly inside the sample folder under `samples`; nested source or implementation READMEs do not replace it.
+* The sample-root README must be based on [the provided template](/samples/README-template.md). It must be named exactly `README.md` -- with capital letters -- as this is the information we use to make your sample public.
   * You will need to have a screenshot picture of your sample in action in the `README.md` file ("pics or it didn't happen"). The preview image must be located in the `/assets/` folder in the root of your solution.
-* The `README` template contains a specific tracking image at the bottom of the file with an `img` tag, where the `src` attribute points to `https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template`. This is a transparent image which is used to track viewership of individual samples in GitHub.
-  * Update the image `src` attribute according with the repository name and folder information. For example, if your sample is named `transmographier` in the `samples` folder, you should update the `src` attribute to `https://telemetry.sharepointpnp.com/powerapps-samples/samples/transmographier`
+* A metadata-backed sample has an `assets/sample.json` file. Keep that metadata synchronized with the sample-root README when names, descriptions, authors, links, or other catalog details change.
+* End every sample-root README with this tracking image:
+
+  ```html
+  <img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/{sample-path}" />
+  ```
+
+  Replace `{sample-path}` with the sample folder's repository-relative path, using forward slashes and no leading or trailing slash. For example, a sample in `samples/transmographier` must end with:
+
+  ```html
+  <img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/transmographier" />
+  ```
+
+  Use the sample-root path, not a nested source folder or README filename.
 * If you find an existing sample which is similar to yours, please extend the existing one rather than submitting a new similar sample
   * For example, if you use Office Graph with React, please add a new web part to the existing solution, rather than introducing a completely new solution
   * When you update existing samples, please update also `README.md` file accordingly with information on provided changes and with your author details
-* When submitting a new sample solution, please name the sample solution folder accordingly
+* If a maintainer asks you to add or relocate a sample in this repository, name the sample solution folder accordingly
   * Folder names should be all lowercase
-  * Do not use words such as `sample`, `powerapp` or `powerapps` in the folder or sample name - this repository is only intended for Power Apps samples, so no need to be redundant redundant.
+  * Do not use words such as `sample`, `powerapp` or `powerapps` in the folder or sample name - this repository is only intended for Power Apps samples, so there is no need to be redundant.
 * Do not use period/dot in the folder name of the provided sample
 
 ## Submitting Pull Requests
 
-Before you submit your pull request, make sure that you [read the guidance on how to create your pull request](https://github.com/pnp/powerapps-samples/wiki/How-to-submit-a-Power-App-sample).
+For new samples, follow the [Power Platform Samples contribution guidance](https://github.com/pnp/powerplatform-samples/blob/main/CONTRIBUTING.md). For fixes and improvements to existing content in this repository, use the process below.
 
-Here's a high-level process for submitting new samples or updates to existing ones.
+Here's a high-level process for submitting fixes and improvements to this repository.
 
 1. Sign the Contributor License Agreement (see below)
-2. Fork this repository [pnp/powerapp-samples](https://github.com/pnp/powerapps-samples) to your GitHub account
+2. Fork this repository [pnp/powerapps-samples](https://github.com/pnp/powerapps-samples) to your GitHub account
 3. Create a new branch from the `main` branch for your fork for the contribution
 4. Include your changes to your branch
 5. Commit your changes using descriptive commit message * These are used to track changes on the repositories for monthly communications
@@ -142,8 +157,12 @@ Before we can accept your pull requests you will be asked to sign electronically
 
 You can find Microsoft CLA from the following address - https://cla.microsoft.com.
 
+## Community calls and demos
+
+Everyone is welcome at the [weekly community calls](https://aka.ms/community/calls) for Copilot, Microsoft 365, and Power Platform updates. To share your learnings or get community input, [sign up for a demo](https://aka.ms/community/request/demo).
+
 Thank you for your contribution.
 
 > Sharing is caring.
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/CONTRIBUTING.md" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/CONTRIBUTING.md" />

README.md

@@ -5,7 +5,7 @@
 
 This repository contains community samples that demonstrate different usage patterns for Power Apps. 
 
-> We welcome community contributions to the `samples` folder in this repository for demonstrating different use cases with Power Apps.
+> We welcome fixes and improvements to the existing samples in this repository. Submit new samples to the [Power Platform Samples repository](https://github.com/pnp/powerplatform-samples).
 
 ## Have issues or questions?
 
@@ -15,6 +15,12 @@ Please use following logic on submitting your questions or issues to right locat
 
 - [Power Platform Community](https://powerusers.microsoft.com/)
 
+## Join the community calls
+
+Stay up to date with the latest Copilot, Microsoft 365, and Power Platform topics by joining our weekly community calls. Everyone is welcome. Come to learn, ask questions, and connect with the community.
+
+[View the call schedule and download the recurring invites](https://aka.ms/community/calls) so you don't miss an upcoming call.
+
 ## Using the samples
 
 Please refer to [this article](https://github.com/pnp/powerapps-samples/wiki/How-to-use-Power-Apps-samples) to get you started.
@@ -25,7 +31,7 @@ This repository's contributors are all community members who volunteered their t
 
 ## Contributions
 
-These samples are direct from the feature teams, [PnP team](http://aka.ms/m365pnp) or shared by the community. We welcome your input on issues and suggestions for new samples. We do also welcome community contributions. If you have any questions, just let us know.
+These samples are direct from the feature teams, [PnP team](http://aka.ms/m365pnp), or shared by the community. We welcome issues, suggestions, and contributions that improve the existing samples. If you have any questions, just let us know.
 
 Please have a look on our [Contribution Guidance in the Power Platform Samples repository](https://github.com/pnp/powerplatform-samples/blob/main/CONTRIBUTING.md) before you submit your pull requests in that repository, so that we can get your contribution processed as fast as possible.
 
@@ -35,4 +41,4 @@ This repository has adopted the [Microsoft Open Source Code of Conduct](https://
 
 > Sharing is caring!
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/README.md" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/README.md" />

SECURITY.md

@@ -17,4 +17,4 @@ To report a vulnerability, please [create an issue](https://github.com/pnp/power
 
 Upon receipt of the issue, we will flag the sample as having a suspected vulnerability and request the support from the community to identify and resolve, if possible, the issue.
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/SECURITY.md" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/SECURITY.md" />

SUPPORT.md

@@ -35,4 +35,4 @@ We use GitHub issues to support user suggestions. To request an enhanced, [open
 
 We use GitHub issues to support sample request. To request a new sample, [open a new issue](https://github.com/pnp/powerapps-samples/issues/new/choose) and select the sample request template. 
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/SUPPORT.md" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/SUPPORT.md" />

samples/EmailTranslate/README.md

@@ -83,7 +83,7 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template" />
 
 ---
 
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/EmailTranslate" />

samples/FileFormatChanger/README.md

@@ -82,6 +82,7 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template" />
 
 ---
+
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/FileFormatChanger" />

samples/HelpDesk-theme/readme.md

@@ -99,6 +99,4 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
-
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/containers-example" />
-
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/HelpDesk-theme" />

samples/InvoiceProcessing/README.md

@@ -80,4 +80,4 @@ The Power App in the solution has 2 data connections to the Invoices library and
 ## Import the Invoices Syntex Model
 The pre-built invoices model in Syntex is used to process the header information of the invoice.  The .classifier file should be uploaded to your Syntex content center and then deployed to the Invoices document library.
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/InvoiceProcessing" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/InvoiceProcessing" />

samples/Keyword-Tagging/README.md

@@ -117,6 +117,7 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template" />
 
 ---
+
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/Keyword-Tagging" />

samples/Microsoft-Graph-toolkit-people-picker/README.md

@@ -93,3 +93,5 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 
 * [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 * [Power Apps canvas apps documentation](https://docs.microsoft.com//powerapps/maker/canvas-apps/)
+
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/Microsoft-Graph-toolkit-people-picker" />

samples/PDF-Reader-Creator-Kit/README.md

@@ -98,3 +98,5 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 * [Power Apps canvas apps documentation](https://docs.microsoft.com/powerapps/maker/canvas-apps/)
 * [Creator Kit](https://learn.microsoft.com/power-platform/guidance/creator-kit/overview)
 * [Read my blog - https://angelogulisano.com](https://angelogulisano.com/)
+
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/PDF-Reader-Creator-Kit" />

samples/PowerHappening/README.md

@@ -112,5 +112,4 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 
 - [User Manual](https://github.com/BendenBlanken/PowerHappening/wiki/2.-User-manual)
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template" />
-
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/PowerHappening" />

samples/README-template.md

@@ -122,7 +122,7 @@ You can also use the [Power Apps CLI](https://aka.ms/pac/docs) to pack the sourc
 
 > Note: don't worry about this section, we'll update the links.
 
-We do not support samples, but we this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for  community members to volunteer their time and help resolve issues.
+We do not support samples, but this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.
 
 If you encounter any issues while using this sample, you can [create a new issue](https://github.com/pnp/powerapps-samples/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&template=bug-report.yml&sample=YOURSAMPLENAME&authors=@YOURGITHUBUSERNAME&title=YOURSAMPLENAME%20-%20).
 
@@ -135,9 +135,11 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
-
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template" />
-
 ---
 > Note that better pictures and documentation will increase the sample usage and the value you are providing for others. Thanks for your submissions in advance! You rock ❤.
 > DELETE THIS PARAGRAPH BEFORE SUBMITTING
+
+> Replace `{sample-path}` below with this sample folder's repository-relative path, such as `samples/transmographier`. Use forward slashes, do not include a leading or trailing slash, and keep the tracker as the final line of the sample-root README.
+> DELETE THIS PARAGRAPH BEFORE SUBMITTING
+
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/{sample-path}" />

samples/SearchMovies/README.MD

@@ -93,6 +93,7 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 * [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 * [Power Apps canvas apps documentation](https://docs.microsoft.com/powerapps/maker/canvas-apps/)
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/SearchMovies" />
 
 ---
+
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/SearchMovies" />

samples/Tagbox/README.md

@@ -100,4 +100,4 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/tagbox" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/Tagbox" />

samples/TheSvgWorld-SVGexamples/README.md

@@ -96,7 +96,4 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
-
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template" />
-
-
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/TheSvgWorld-SVGexamples" />

samples/Timesheet/README.md

@@ -141,4 +141,4 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/timesheet" />
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/Timesheet" />

samples/US-Map-with-SVG-Images/Readme.md

@@ -91,7 +91,4 @@ Finally, if you have an idea for improvement, [make a suggestion](https://github
 - [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
 - [Power Apps canvas apps documentation](https://docs.microsoft.com/en-us/powerapps/maker/canvas-apps/)
 
-
-<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/readme-template" />
-
-
+<img src="https://m365-visitor-stats.azurewebsites.net/powerapps-samples/samples/US-Map-with-SVG-Images" />