Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

代码示例问题的收集 #3196

Open
kenlig opened this issue May 27, 2021 · 0 comments
Open

代码示例问题的收集 #3196

kenlig opened this issue May 27, 2021 · 0 comments
Labels
Discussion / 需要讨论 Further discussion is welcome help wanted / 需要帮助 Extra attention is needed summer2021

Comments

@kenlig
Copy link
Contributor

kenlig commented May 27, 2021

我遇到的问题是

在OI-wiki中,我们的示例代码经常会出现“讲得很好,但是看不懂代码”的情况。现在我们准备收集并整理、修复有这些代码的页面和代码。

我希望能有这样的解决方案

各位同学可以在issue里提出有问题的页面和代码,并给出你认为合理的解决方案。
问题包括但不限于:缺少必要的main函数和测试数据来测试代码;拥有宏定义/各种缩写/各种让人看不懂的地方的代码;觉得本处代码质量明显低于其他地方的代码。
解决方案包括但不限于:重构代码;对代码增加注释;对代码块增加main函数;增加测试数据

我觉得其他这些方案也可以接受

@Tiphereth-A Tiphereth-A changed the title add 代码示例问题的收集 代码示例问题的收集 Jan 10, 2024
@Tiphereth-A Tiphereth-A added Discussion / 需要讨论 Further discussion is welcome and removed Content Request / 内容请求 New feature or request labels Jan 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Discussion / 需要讨论 Further discussion is welcome help wanted / 需要帮助 Extra attention is needed summer2021
Projects
None yet
Development

No branches or pull requests

4 participants