49 lines
2.9 KiB
Markdown
49 lines
2.9 KiB
Markdown
# 第一、二题提交说明
|
|
|
|
> 当前为筹备稿。目录规范和“个人分支 → PR → 干部审核合并”的方式已确定；负责人试跑后会补充具体页面操作与权限安排。正式开放时间、截止时刻以[仓库首页](../README.md)为准。
|
|
|
|
## 一、整理个人文件夹
|
|
|
|
前两题统一放在一个个人文件夹中，文件夹名称为 **两位年级＋姓名**，中间不加空格或符号。例如，25 级刁泓宁使用 `25刁泓宁`。
|
|
|
|
个人文件夹统一放在原仓库的 `submissions/` 下，保留以下目录结构，直接提交其中的文件，无需另外压缩为 ZIP：
|
|
|
|
```text
|
|
submissions/
|
|
└── 25刁泓宁/
|
|
├── 01-basics/
|
|
│ ├── main.swift
|
|
│ └── screenshots/
|
|
│ ├── run-01.png
|
|
│ └── run-02.png
|
|
└── 02-design/
|
|
└── design.pdf
|
|
```
|
|
|
|
- `01-basics/main.swift`：第一题源码。
|
|
- `01-basics/screenshots/`：真实运行截图，覆盖第一题要求的 A–F；数量按实际需要，PNG 或 JPG 均可。
|
|
- `02-design/design.pdf`：第二题完整设计文档，只需一份 PDF。
|
|
|
|
将示例文件夹名换成自己的年级与姓名。`25刁泓宁` 仅为命名示例，不是待填写的公共文件夹。文件具体要求见[第一题](../tasks/01-basics.md)和[第二题](../tasks/02-design.md)。
|
|
|
|
## 二、通过个人分支与 PR 提交
|
|
|
|
1. 从**本仓库最新的 `main`** 创建自己的分支。建议命名为 `submission/年级-姓名拼音`，例如 `submission/25-diaohongning`。
|
|
2. 在个人分支中加入 `submissions/自己的年级姓名/` 文件夹，并提交其中的两题材料。
|
|
3. 创建一个 Pull Request（PR）：**来源分支选自己的分支，目标分支选本仓库的 `main`**。
|
|
4. PR 标题使用 `年级姓名：提交第一、二题`，例如 `25刁泓宁：提交第一、二题`。正文简述两题完成情况；有未完成部分或已知问题时如实说明。
|
|
5. 查看 PR 的文件变更，确认只包含自己文件夹中的材料，源码、截图和 PDF 对应本次提交的版本，然后交由干部审核合并。
|
|
|
|
前两题使用原仓库内的个人分支，无需 Fork。不要把材料直接提交到 `main`，也不要改动其他人的文件夹或原题、模板。
|
|
|
|
PR 尚未合并时需要补交或修改，继续在同一个个人分支提交，原 PR 会随之更新。已合并后需要再修改，从最新 `main` 创建新分支，只修改自己的文件夹，再发起补交 PR。
|
|
|
|
## 三、提交前检查
|
|
|
|
- 个人文件夹名称、所在位置和两题子目录正确。
|
|
- 源码与截图一致，截图文字清楚；PDF 可以打开，草图和文字完整可读。
|
|
- 没有遗留文档模板中的填写提示。
|
|
- PR 来源是个人分支，目标是 `main`，变更只涉及自己的文件夹。
|
|
|
|
同年级同名、无法创建分支或无法提交时，联系干部确认标识或权限安排。
|