From 1feff078ade6750abceff3899203424115b31c29 Mon Sep 17 00:00:00 2001 From: Dakshata Mishra Date: Thu, 23 Oct 2025 11:49:26 +0000 Subject: [PATCH 1/3] Add tech-article-explainer recipe Signed-off-by: Dakshata Mishra --- .../data/recipes/tech-article-explainer.yaml | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml diff --git a/documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml b/documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml new file mode 100644 index 000000000000..8db9d9a3b066 --- /dev/null +++ b/documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml @@ -0,0 +1,67 @@ +version: 1.0.0 +title: Technical Article Explainer +description: Reads a technical article file, summarizes it, and explains key technical terms simply for {{ target_audience }} +author: + contact: the-matrixneo + +activities: + - Read and analyze a technical article from the specified path + - Summarize the article’s core idea in 2–3 sentences + - Identify 3–5 important technical concepts + - Write beginner-friendly explanations for each concept, using analogies + - Format the summary and explanations into markdown + - Save the result to the specified output path + +parameters: + - key: article_file_path + input_type: string + requirement: required + description: Path to the technical article file to analyze + + - key: output_file_path + input_type: string + requirement: required + description: Where to save the simplified explanation (.md) + + - key: target_audience + input_type: select + requirement: optional + default: "beginner" + description: Intended audience for the explanation. + options: + - beginner + - intermediate + - expert + - auto + +instructions: | + 1. Read {{ article_file_path }} and confirm the file exists. + 2. Summarize the main objective of the article in plain English. + 3. Identify up to 5 key terms likely to be unfamiliar to {{ target_audience }}. + 4. Create simple explanations for each, using real-world comparisons. + 5. Format the output as: + # Explanation of [Article Title] + ## Summary + [summary] + ## Key Concepts Explained + - **[Concept 1]:** [simple explanation] + - **[Concept 2]:** [simple explanation] + ...etc. + 6. Save this markdown content to {{ output_file_path }}. + 7. Report completion and the location of the saved file. + +extensions: + - type: builtin + name: developer + display_name: Developer + timeout: 300 + bundled: true + description: Performs file operations, content parsing, and markdown formatting + +prompt: | + Create a simplified explanation of {{ article_file_path }} for {{ target_audience }}. + - Read and analyze the file. + - Summarize the article in plain English. + - Identify and explain up to 5 key technical concepts for beginners. + - Format and save your markdown output to {{ output_file_path }}. + - Confirm where the result is saved. From d2926e463516e52497d03a58b77cad2999a24fa1 Mon Sep 17 00:00:00 2001 From: Dakshata <22-783@apsdhaulakuan.onmicrosoft.com> Date: Wed, 29 Oct 2025 04:17:59 +0530 Subject: [PATCH 2/3] Update community content and contributing docs Signed-off-by: Dakshata <22-783@apsdhaulakuan.onmicrosoft.com> --- .../src/pages/community/data/community-content.json | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/documentation/src/pages/community/data/community-content.json b/documentation/src/pages/community/data/community-content.json index a60b8324f39a..2e184d870740 100644 --- a/documentation/src/pages/community/data/community-content.json +++ b/documentation/src/pages/community/data/community-content.json @@ -80,6 +80,18 @@ "submittedDate": "2025-10-16", "tags": ["hacktoberfest"], "hacktoberfest": true + }, + { + "title": "Goose with Context7 MCP", + "author": { + "name": "Dakshata Mishra", + "handle": "the-matrixneo" + }, + "type": "video", + "url": "https://www.youtube.com/shorts/EmLcx5gKHsE", + "submittedDate": "2025-10-29", + "tags": ["hacktoberfest"], + "hacktoberfest": true } ] } From 4478d6aa6b9b2b2b87c0cda84e5acb0161ba14ed Mon Sep 17 00:00:00 2001 From: Dakshata <22-783@apsdhaulakuan.onmicrosoft.com> Date: Wed, 29 Oct 2025 04:37:56 +0530 Subject: [PATCH 3/3] Remove accidental recipe file Signed-off-by: Dakshata <22-783@apsdhaulakuan.onmicrosoft.com> --- .../data/recipes/tech-article-explainer.yaml | 67 ------------------- 1 file changed, 67 deletions(-) delete mode 100644 documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml diff --git a/documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml b/documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml deleted file mode 100644 index 8db9d9a3b066..000000000000 --- a/documentation/src/pages/recipes/data/recipes/tech-article-explainer.yaml +++ /dev/null @@ -1,67 +0,0 @@ -version: 1.0.0 -title: Technical Article Explainer -description: Reads a technical article file, summarizes it, and explains key technical terms simply for {{ target_audience }} -author: - contact: the-matrixneo - -activities: - - Read and analyze a technical article from the specified path - - Summarize the article’s core idea in 2–3 sentences - - Identify 3–5 important technical concepts - - Write beginner-friendly explanations for each concept, using analogies - - Format the summary and explanations into markdown - - Save the result to the specified output path - -parameters: - - key: article_file_path - input_type: string - requirement: required - description: Path to the technical article file to analyze - - - key: output_file_path - input_type: string - requirement: required - description: Where to save the simplified explanation (.md) - - - key: target_audience - input_type: select - requirement: optional - default: "beginner" - description: Intended audience for the explanation. - options: - - beginner - - intermediate - - expert - - auto - -instructions: | - 1. Read {{ article_file_path }} and confirm the file exists. - 2. Summarize the main objective of the article in plain English. - 3. Identify up to 5 key terms likely to be unfamiliar to {{ target_audience }}. - 4. Create simple explanations for each, using real-world comparisons. - 5. Format the output as: - # Explanation of [Article Title] - ## Summary - [summary] - ## Key Concepts Explained - - **[Concept 1]:** [simple explanation] - - **[Concept 2]:** [simple explanation] - ...etc. - 6. Save this markdown content to {{ output_file_path }}. - 7. Report completion and the location of the saved file. - -extensions: - - type: builtin - name: developer - display_name: Developer - timeout: 300 - bundled: true - description: Performs file operations, content parsing, and markdown formatting - -prompt: | - Create a simplified explanation of {{ article_file_path }} for {{ target_audience }}. - - Read and analyze the file. - - Summarize the article in plain English. - - Identify and explain up to 5 key technical concepts for beginners. - - Format and save your markdown output to {{ output_file_path }}. - - Confirm where the result is saved.