Skip to content

docs: Update Gitea tutorial and contact information with new references - #52

Merged
Maoyao233 merged 11 commits into
Tongji-High-level-Language-Programming:mainfrom
oierxjn:docs/gitea-tut
Sep 13, 2026
Merged

Maoyao233 merged 11 commits into
Tongji-High-level-Language-Programming:mainfrom
oierxjn:docs/gitea-tut

Conversation

@oierxjn

@oierxjn oierxjn commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

主要修改

添加 Gitea 高程答疑平台 面向学生的教程

更新答疑相关信息,QQ群->答疑平台

@Maoyao233 Maoyao233 changed the title docs: Update Gitea tutorial and contact information with new references WIP: docs: Update Gitea tutorial and contact information with new references Sep 3, 2026
@Maoyao233
Maoyao233 marked this pull request as draft September 3, 2026 14:00
@Maoyao233

Copy link
Copy Markdown
Contributor

Gitea 界面后续可能会微调,帮助内容后续也考虑修改补充,暂时保持WIP状态

@Maoyao233
Maoyao233 self-requested a review September 11, 2026 08:54

@Maoyao233 Maoyao233 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

导向答疑平台的入口层级偏低,只在“常见问题”的子项中:建议在首页、顶部导航都添加答疑平台入口。

其他细节问题见行内评论。

Gitea 定制工作正在推进,截图已经过期了一些、剩下的一些也随时可能过期。我们首先定稿定制工作,再收尾本 PR。

Comment thread docs/faq/gitea/index.md Outdated

## 注册与登录

账号目前由管理员统一开通,没有额外的注册入口。有问题请[联系团队](/contact.md)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

引用站内路径统一不带 .md

Comment thread docs/faq/gitea/index.md Outdated
+ 可以方便地追踪问题的解决进度
+ 其他同学遇到相同问题时可以搜索到已有的解答,避免重复提问/解答浪费时间
+ 按知识模块分类管理,便于针对性地查找
+ 可以挑选出有价值的问题,供所有人方便地参考 No newline at end of file

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

缺少末尾换行

Comment thread docs/qa/gitea/index.md

+ **组织(Organization)**:按年份划分,对应每一届课程
+ **仓库(Repository)**:暂时没有划分规则

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里可以附加一个卡片,简单介绍一下“Issue”这个概念

Comment thread docs/faq/gitea/index.md Outdated

## 为什么 Gitea 作为答疑平台?

> Gitea 是一个轻量级的 DevOps 平台软件。从开发计划到产品成型的整个软件生命周期,他都能够高效而轻松的帮助团队和开发者。包括 Git 托管、代码审查、团队协作、软件包注册和 CI/CD。它与 GitHub、Bitbucket 和 GitLab 等比较类似。 Gitea 最初是从 Gogs 分支而来,几乎所有代码都已更改。Gitea的首要目标是创建一个极易安装,运行非常快速,安装和使用体验良好 的自建 Git 服务。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里介绍 Gitea 的文字对于初学者来说有点过于难懂了,可以考虑直接删掉。整段语序可能可以考虑组织为先介绍答疑平台的设计理念(即后面使用 Issue 答疑的好处),然后增加一个 Detail 卡片放补充阅读,用面向初学者的语言简要介绍 git 是什么、github/gitea 是什么(直接给外链或者不写也可)。

@Maoyao233 Maoyao233 mentioned this pull request Sep 11, 2026
1 of 3 tasks
@Maoyao233
Maoyao233 marked this pull request as ready for review September 11, 2026 09:09
@Maoyao233 Maoyao233 changed the title WIP: docs: Update Gitea tutorial and contact information with new references docs: Update Gitea tutorial and contact information with new references Sep 11, 2026
@oierxjn

oierxjn commented Sep 12, 2026

Copy link
Copy Markdown
Contributor Author

收到,正在修改

@oierxjn
oierxjn requested a review from Maoyao233 September 12, 2026 10:31
@oierxjn

oierxjn commented Sep 12, 2026

Copy link
Copy Markdown
Contributor Author

入口正在修改

@Maoyao233

Copy link
Copy Markdown
Contributor

LGTM.

文案细节仍存在少许可以调整的地方,我稍后改动,你不必继续修改。

「为什么 Gitea 作为答疑平台?」一节对初学者仍偏难,后续可以写一些编写对初学者更友好的文案。不必在这个 PR 中完成。

另外我做了一些结构上的调整,统一了答疑入口:原先问答内容分散在 /faq/ 和 /ask-question/ 两个目录,导航栏里同时存在「FAQ」和「答疑」两个入口。现在整合为单一入口 /qa/:

页面 新路径 原路径
答疑(总览,新增) /qa/ —
提问指南 /qa/ask/ /ask-question/
答疑平台使用指南 /qa/gitea/ /faq/gitea/(本 PR 新增)
常见问题解答 /qa/faq/ /faq/
区域和语言设置 /qa/faq/region/ /faq/region/
  • 导航栏只保留一个「答疑」总入口,指向 /qa/。
  • 侧边栏「答疑」组下依次列出三个子页:提问指南 / 答疑平台 / 常见问题解答。
  • 首页 hero 原「学会提问」与「FAQ」两个按钮合并为一个「答疑」。
  • 旧地址已通过 docs/public/ 下的重定向页跳转到新地址,已发布出去的链接不会失效。

同时明确了 QQ 群与答疑平台的分工,调整了 /qa/gitea/、/qa/ask/、/contact、/getting-started/ 等处原先指向 QQ 群的提问指引。

@Maoyao233
Maoyao233 merged commit f4197a0 into Tongji-High-level-Language-Programming:main Sep 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants