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

peer review for Momentum #28

Open
yh73 opened this issue May 19, 2018 · 0 comments
Open

peer review for Momentum #28

yh73 opened this issue May 19, 2018 · 0 comments

Comments

@yh73
Copy link

yh73 commented May 19, 2018

I reviewed the user manual and the documentation parts. The main reason I choose these two parts is they are significant for users to understand how to use your app and why your app is better than other similar projects.
I really like the user manual after fully reviewing it. It contains most parts I want to see from a user manual. Those pictures are really nice for users who are not familiar with your project (like me) to follow up your mind. However, I think giving a living demo (like what you showed in the presentation) would be better for users to understand how your app works. Also, you mentioned user thoughtfulness more important than user accuracy, and I understand it is really hard to make a prediction about how long it would take before starting a project. However, I actually don't know how would you make better estimation if their estimations are not accurate. Based on what you showed on the user manual, they cannot supply any additional information during the task, like important problems they overcome or encountered. I think receiving these information would be better for your app to make precise prediction.
Another problem about the user manual is the signup link. When I clicked on it, it showed a new web page (React App) but nothing is in it. The link follows the signup link has the same problem.
For the documentation part, I think it is really important to include how to setup your app on systems other than macOS. Also, when you tell users to install something, it might be better to give them a link like what you did in the info part or specify the version since most software have numerous versions, but your system might only works on some of them.

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

No branches or pull requests

1 participant