From 0eaaacce8c0cca1ead43e1ee0c7958e004c2642d Mon Sep 17 00:00:00 2001 From: Honglin Du <0mza987@gmail.com> Date: Tue, 14 Nov 2023 19:56:56 +0800 Subject: [PATCH 1/4] Add integration folder guideline --- examples/flows/integrations/README.md | 44 +++++++++++++++++++ .../standard/web-classification/README.md | 6 ++- 2 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 examples/flows/integrations/README.md diff --git a/examples/flows/integrations/README.md b/examples/flows/integrations/README.md new file mode 100644 index 00000000000..7718775da13 --- /dev/null +++ b/examples/flows/integrations/README.md @@ -0,0 +1,44 @@ +# Integrations Folder + +This folder contains flow examples contributed by various contributors. Each flow example should have a README.md file that provides a comprehensive introduction to the flow and includes contact information for the flow owner. + +# Guideline for README.md of flows + +To ensure consistency and clarity, please follow the guidelines below when creating the README.md file for your flow example. You can also refer to the [README.md](../standard/web-classification/README.md) file in the [web-classification](../standard/web-classification) flow example as a reference. + +## Introduction + +Provide a detailed description of the flow, including its components, inputs, outputs, and any dependencies. Explain how the flow works and what problem it solves. This section should give users a clear understanding of the flow's functionality and how it can be used. + +## Tools Used in this Flow + +List all the tools (functions) used in the flow. This can include both standard tools provided by prompt flow and any custom tools created specifically for the flow. Include a brief description of each tool and its purpose within the flow. + +## Pre-requisites + +List any pre-requisites that are required to run the flow. This can include any specific versions of prompt flow or other dependencies. If there are any specific configurations or settings that need to be applied, make sure to mention them in this section. + +## Getting Started + +Provide step-by-step instructions on how to get started with the flow. This should include any necessary setup or configuration steps, such as installing dependencies or setting up connections. If there are specific requirements or prerequisites, make sure to mention them in this section. + +## Usage Examples + +Include usage examples that demonstrate how to run the flow and provide input data. This can include command-line instructions or code snippets. Show users how to execute the flow and explain the expected output or results. + +## Troubleshooting + +If there are any known issues or troubleshooting tips related to the flow, include them in this section. Provide solutions or workarounds for common problems that users may encounter. This will help users troubleshoot issues on their own and reduce the need for support. + +## Contribution Guidelines + +If you would like to encourage other users to contribute to your flow or provide guidelines for contributing to the integration folder, include a section with contribution guidelines. This can include instructions on how to submit pull requests, guidelines for code formatting, or any other relevant information. + + +## Contact + +Specify the flow owner and provide contact information in the README.md file. This can include an email address, GitHub username, or any other preferred method of contact. By including this information, users will be able to reach out to the owner with any questions or issues related to the flow. + +# Conclusion + +By following these guidelines, you can create a well-structured and informative README.md file for your flow example. This will help users understand and utilize your flow effectively. If you have any further questions or need assistance, please don't hesitate to reach out. Happy contributing! diff --git a/examples/flows/standard/web-classification/README.md b/examples/flows/standard/web-classification/README.md index a2493686bbd..acd9151d511 100644 --- a/examples/flows/standard/web-classification/README.md +++ b/examples/flows/standard/web-classification/README.md @@ -128,4 +128,8 @@ pfazure run show --name $run_name pfazure run show-details --name $run_name pfazure run show-metrics --name $run_name pfazure run visualize --name $run_name -``` \ No newline at end of file +``` + +## Contact + +If you have any questions or feedbacks, please reach out to \ No newline at end of file From ab924ad746aa8be8be4ae1aac7bf460c9f7b2f60 Mon Sep 17 00:00:00 2001 From: Honglin Du <0mza987@gmail.com> Date: Wed, 15 Nov 2023 14:04:16 +0800 Subject: [PATCH 2/4] Update integration readme --- examples/flows/integrations/README.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/examples/flows/integrations/README.md b/examples/flows/integrations/README.md index 7718775da13..a076998e6e5 100644 --- a/examples/flows/integrations/README.md +++ b/examples/flows/integrations/README.md @@ -6,19 +6,21 @@ This folder contains flow examples contributed by various contributors. Each flo To ensure consistency and clarity, please follow the guidelines below when creating the README.md file for your flow example. You can also refer to the [README.md](../standard/web-classification/README.md) file in the [web-classification](../standard/web-classification) flow example as a reference. -## Introduction +Note: Above sample README.md may not have contact information because it's a shared example and people can open issues to this repository if they have any questions about the flow exmaple. For integration samples, **please make sure to include contact information in your README.md file**. + +## Introduction (Required) Provide a detailed description of the flow, including its components, inputs, outputs, and any dependencies. Explain how the flow works and what problem it solves. This section should give users a clear understanding of the flow's functionality and how it can be used. -## Tools Used in this Flow +## Tools Used in this Flow (Required) List all the tools (functions) used in the flow. This can include both standard tools provided by prompt flow and any custom tools created specifically for the flow. Include a brief description of each tool and its purpose within the flow. -## Pre-requisites +## Pre-requisites (Required) List any pre-requisites that are required to run the flow. This can include any specific versions of prompt flow or other dependencies. If there are any specific configurations or settings that need to be applied, make sure to mention them in this section. -## Getting Started +## Getting Started (Required) Provide step-by-step instructions on how to get started with the flow. This should include any necessary setup or configuration steps, such as installing dependencies or setting up connections. If there are specific requirements or prerequisites, make sure to mention them in this section. @@ -35,7 +37,7 @@ If there are any known issues or troubleshooting tips related to the flow, inclu If you would like to encourage other users to contribute to your flow or provide guidelines for contributing to the integration folder, include a section with contribution guidelines. This can include instructions on how to submit pull requests, guidelines for code formatting, or any other relevant information. -## Contact +## Contact (Required) Specify the flow owner and provide contact information in the README.md file. This can include an email address, GitHub username, or any other preferred method of contact. By including this information, users will be able to reach out to the owner with any questions or issues related to the flow. From 75e40121d6e90897132b42ca4b17b344c64b4e4a Mon Sep 17 00:00:00 2001 From: Honglin Du <0mza987@gmail.com> Date: Wed, 15 Nov 2023 14:14:47 +0800 Subject: [PATCH 3/4] recover sample readme --- examples/flows/standard/web-classification/README.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/examples/flows/standard/web-classification/README.md b/examples/flows/standard/web-classification/README.md index acd9151d511..a2493686bbd 100644 --- a/examples/flows/standard/web-classification/README.md +++ b/examples/flows/standard/web-classification/README.md @@ -128,8 +128,4 @@ pfazure run show --name $run_name pfazure run show-details --name $run_name pfazure run show-metrics --name $run_name pfazure run visualize --name $run_name -``` - -## Contact - -If you have any questions or feedbacks, please reach out to \ No newline at end of file +``` \ No newline at end of file From d96299953abfac51b7b15cb472c694ce3f082c01 Mon Sep 17 00:00:00 2001 From: Honglin Du <0mza987@gmail.com> Date: Wed, 15 Nov 2023 14:30:05 +0800 Subject: [PATCH 4/4] fix spell --- examples/flows/integrations/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/examples/flows/integrations/README.md b/examples/flows/integrations/README.md index a076998e6e5..77102a6e841 100644 --- a/examples/flows/integrations/README.md +++ b/examples/flows/integrations/README.md @@ -6,7 +6,7 @@ This folder contains flow examples contributed by various contributors. Each flo To ensure consistency and clarity, please follow the guidelines below when creating the README.md file for your flow example. You can also refer to the [README.md](../standard/web-classification/README.md) file in the [web-classification](../standard/web-classification) flow example as a reference. -Note: Above sample README.md may not have contact information because it's a shared example and people can open issues to this repository if they have any questions about the flow exmaple. For integration samples, **please make sure to include contact information in your README.md file**. +Note: Above sample README.md may not have contact information because it's a shared example and people can open issues to this repository if they have any questions about the flow example. For integration samples, **please make sure to include contact information in your README.md file**. ## Introduction (Required)