← 中文资源

简体中文版本

README 引导工作流

为新仓库创建包含项目名、设置说明和用法的最小 README。

阅读英文原文

概述

README 引导工作流是一个初级难度的工作流。为新仓库创建包含项目名、设置说明和用法的最小 README。该工作流的目标是:Provide enough documentation for a new contributor to clone and run the project within 10 minutes.

环境准备

执行本工作流需要以下环境:A new Git repository;A project with a defined build and run process;A text editor。请确保在开始前准备好所有必需的工具和资源,以避免中途因环境问题中断。

执行步骤

本工作流包含4个步骤。步骤1:Create README.md——Create a README.md file with the project name as the top-level heading. 步骤2:Add setup section——Document the clone, install, and run commands needed to start the project. 步骤3:Add usage section——Add a usage section with at least one example command or code snippet. 步骤4:Verify by following——Follow the README from scratch in a clean environment to verify accuracy.

验证与清理

预期结果:A new contributor can clone the repository and have the project running by following the README alone.。验证方法:Ask someone unfamiliar with the project to follow the README and confirm they can run it successfully.。清理操作:No cleanup needed.。estimatedMinutes 为 30 分钟。

代码示例

# My Project

A short description.

## Setup