Importing modules in assessments about modules HOT 4 OPEN

Thanks, Ningyuan and Eldric for your input. So it seems that my original proposal is getting your approval.

FYI: With Eldric, I have discussed documentation of libraries and we think that there are ways to put together a library document using JSDoc and the functions selected in the assessment XML via <SYMBOL>.

from modules.

I've been discussing the documentation of the library functions with @blackening . We can generate the documentation of the libraries using tools like JSDoc. In that case, all exported functions would show up in the document, regardless of what functions the mission author decides to import. In other words, there may be functions in the module documentation that are not actually imported by the author of the mission. So perhaps we need to insist that all functions that are exported by a module are also imported in the mission? In that case, maybe we should not require that the author of the mission lists the imported functions using <SYMBOL> tags, and instead import all exported functions? The tag would be simply like this:

<IMPORT module="cs1101s_1920/two_dim_runes"/>

from modules.

The SYMBOL tag will allow assessment authors to selectively import only what they want to import. So if for any reason there is some part of an external library that the assessment author wishes to omit to the student, they can import selectively via SYMBOL tags.

Admittedly, the scenario itself is rather troublesome. Historically, selective imports hid functions because students are being asked to write those exact same functions. They could easily inspect the external library from their browser to find the answer.

Either way, I think it is also good not to crowd the global namespace with unnecessary functions.

from modules.

See: https://github.com/source-academy/assessments/wiki/Assessments#import

postponed till 20/21

from modules.