Prompting Workflow: Implementation Guide Document - da-moon/llm-playground GitHub Wiki
Table Of Contents
1. Overview
Purpose:
The Implementation Guide provides detailed instructions and guidelines on how to implement specific design patterns, frameworks, or technologies within the project. It ensures that all team members follow a consistent approach and understand the best practices associated with the implementation.
When to Use:
- When introducing a new design pattern, framework, or technology to the project.
- To provide guidance on how to apply specific implementations consistently across the project.
2. Structure and Content
2.1 Overview
Purpose: Provide an introduction to the design pattern, framework, or technology being implemented.
Content:
- Introduction: A brief description of what is being implemented and why it is necessary.
- Use Cases: Scenarios where this implementation is applicable.
- Benefits: The advantages of using this approach in the project.
2.2 Step-by-Step Instructions
Purpose: Offer detailed, step-by-step guidance on how to implement the pattern or technology.
Content:
-
Step 1:
- Description: Detailed instructions for the first step.
- Example: Provide a code snippet or example to illustrate the step.
- Tools/Resources: Any specific tools, libraries, or resources needed for this step.
-
Step 2:
- Description: Detailed instructions for the next step.
- Example: Provide a code snippet or example to illustrate the step.
- Tools/Resources: Any specific tools, libraries, or resources needed for this step.
(Continue for all implementation steps)
2.3 Best Practices
Purpose: Highlight best practices to ensure the implementation is done correctly and efficiently.
Content:
-
Practice 1:
- Description: A description of the best practice.
- Rationale: Why this practice is important and the potential impact of not following it.
- Example: Provide a real-world example or code snippet.
-
Practice 2:
- Description: A description of the best practice.
- Rationale: Why this practice is important and the potential impact of not following it.
- Example: Provide a real-world example or code snippet.
(Continue for all best practices)
2.4 Examples
Purpose: Provide real-world examples or use cases where this implementation has been successfully applied.
Content:
-
Example 1:
- Description: A detailed description of the example scenario.
- Code Snippet: Include any relevant code snippets or diagrams.
- Outcome: The result or impact of applying the implementation in this scenario.
-
Example 2:
- Description: A detailed description of the example scenario.
- Code Snippet: Include any relevant code snippets or diagrams.
- Outcome: The result or impact of applying the implementation in this scenario.