【问题标题】:What is meant by 'listings for your program'?“您的程序列表”是什么意思?
【发布时间】:2020-01-10 09:18:46
【问题描述】:

我正在为一个大学项目用 Java 编写程序,部分报告指出:

'您必须为您的计划提供列表'

谁能帮我解释一下这是什么意思?

我在网上看了很多东西,但我遇到的任何事情都没有帮助我解决这个问题。我找到了一个定义“对于计算机编程,程序列表是计算机程序、源代码和构成软件程序的所有文件的完整列表”,但他并没有帮助我理解所问的内容报告。

我应该提供我的代码的屏幕截图吗?或者是包含所有相关文件的文件夹的屏幕截图?

任何帮助将不胜感激,谢谢。

【问题讨论】:

  • 截屏没用。他们希望能够检查并可能运行您的代码。这意味着您需要以文本形式提供源代码。
  • 谢谢,@AndyTurner。在您看来,如果我必须在提交时提供可执行应用程序,这是否算作提供列表,还是应该将源代码作为文本粘贴到报告中?
  • 最能回答这个问题的是你的老师。
  • 你发现的和@AndyTurner 说的都是正确的。但是你的老师有没有说你应该如何给他们软件? (例如将其推送到某个存储库或其他什么?)
  • @jhamon 我已经要求我的老师澄清这一点,但我只是被引导到术语“程序列表”的定义。

标签: code-documentation


【解决方案1】:

您的程序列表用于表示您的程序代码呈现为打印形式;即在纸上。如今,这也可能意味着源代码被格式化并包含为 PDF 文件、Word 文档或其他文件。

我应该提供我的代码的屏幕截图吗?

不清楚这是否是您的讲师想要的。我不希望如此,因为屏幕截图比格式化文本更难阅读。

或者是包含所有相关文件的文件夹的屏幕截图?

这不太可能,IMO。如果这是您的讲师想要的,他们会说“目录列表”而不是“您的程序列表”。 (而这对于评估目的来说毫无用处。)


但我的建议是询问你的讲师,如果你不清楚对你的要求是什么。

如果你的讲师不愿意解释,那就做认为正确的事。

【讨论】:

  • "但我的建议是,如果您不清楚对您的要求,请咨询您的讲师。"这。她/他会比一群随机的陌生人更了解。
【解决方案2】:

您发现是正确的,您需要提供源代码和构建和运行软件所需的任何其他资源。

一种选择可能是: - 用一些构建管理器(maven、gradle 等)打包我的项目 - 使用 README.md 将其推送到某个存储库(如 github)以进行构建和运行 - 给出github项目参考。

如果您不想公开代码,只需将其打包并与 maven 项目一起发送存档。

【讨论】:

  • 此建议不相关。问题是询问如何在大学课程中提交代码进行评估。具体来说,如何解释讲师所说的“你必须为你的项目提供清单”这句话的意思。
  • @StephenC 是的,我明白你的意思......但我正在考虑一些很好且广泛的方法来做到这一点(例如,许多课程使用 github 或 gitlab 分发学习示例)。
猜你喜欢
  • 2011-03-26
  • 1970-01-01
  • 2010-12-15
  • 1970-01-01
  • 1970-01-01
  • 2015-04-12
  • 1970-01-01
  • 1970-01-01
  • 2019-11-23
相关资源
最近更新 更多