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

Explore Setting Up of User Guide for Future Students using CATcher #529

Closed
seanlowjk opened this issue Jan 14, 2021 · 6 comments
Closed

Comments

@seanlowjk
Copy link
Contributor

As a student previous who took CS2103T and used CATcher, I initially had no idea how to setup CATcher and to use CATcher's functionality. Even though there were guides on CATcher's usage in CS2103T, it will be good that we have a user guide readily available on our website to bring the user through the different phases. For example, the Bug Reporting Phase and Tester's Response Phase

As such students will be able to view the user guide and learn how to work with CATcher during their Practical Examinations.

p.s. I am not sure which aspect to put it under, so I would put it under Documentation.

@seanlowjk
Copy link
Contributor Author

I am thinking that if possible, we have a video guide for students on how to use CATcher, but I'm not sure if it would be too much. For now, I think we can stick to a simple user guide using GIthub Pages and Markbind!

@damithc
Copy link
Contributor

damithc commented Jan 14, 2021

Given that students survived without even a proper user guide so far (I didn't hear any complaints about it either), I think just a minimal user guide is enough. A video guides will be hard to update when the UI changes. Minimize screenshots and avoid animated gifs too.

@seanlowjk
Copy link
Contributor Author

Alright Prof! Sounds good!

@anubh-v
Copy link
Contributor

anubh-v commented Jan 24, 2021

I think the UG should explain some of our application-specific keywords.
Example of such keywords: Pending issues / Faulty issues / Todos remaining

This will benefit developers who may not have used CATcher, as they'll be able to understand the application faster.

@anubh-v
Copy link
Contributor

anubh-v commented Jan 25, 2021

Another UG related TODO: updating the instructions for the web version
(Instructions specific to the desktop app can be kept in a separate section)

@seanlowjk
Copy link
Contributor Author

Closing the issue for now as https://catcher-org.github.io/ug/index.html is in development

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants