niumainframe / webjcl

Web-based IBM mainframe IDE.
15 stars 12 forks source link

Functionality to coordinate with a TA/Professor #33

Open scvnc opened 10 years ago

scvnc commented 10 years ago

I imagine having a button which allows the student to annotate parts of their code and then send an message to the TAs/Professors registered for the semester. Any professor or TA could accept to review the problem and respond to the student from WebJCL.

The student would be presented a form that would encourage debugging and inspecting their work further before asking questions. Example while highlighting a particular line in their code: "I'm seeing garbage when I'm printing this address and I don't understand why. I swear I'm unpacking these decimals!"

I would suggest that this utilize email/hyperlinks whenever possible. WebJCL would only provide a structured interface for correspondence, including inline code annotations, comments, and potentially even revised versions of their code.

One of the key benefit is that the professor and TA could click a link and be given the same code to view in WebJCL. From there they can fiddle with the code within the browser and identify the problem: then send back the structured correspondence.

This would require persistence enabled at some level.

This will have to be groomed into smaller tasks.

scvnc commented 10 years ago

This touches a broader topic of article annotation. This looks delicious https://github.com/okfn/annotator/wiki/Annotation-format

This would be out of scope of the initial implementaiton

scvnc commented 10 years ago

This was discussed during meetings: having a URL that a TA could receive from the student may be an easy way to handle this.