open-learning-exchange / open-learning-exchange.github.io

http://open-learning-exchange.github.io/
40 stars 333 forks source link

Adding checklists at the end of each step #2507

Open hemu-codes opened 5 years ago

hemu-codes commented 5 years ago

Problem

In each of the steps, the virtual interns are required to complete a certain set of tasks. However, as of right now, there isn't really a checklist where they could check if they did all of the required tasks for each of the steps.

Steps to reproduce the problem

N/A

Screenshots

Screen Shot 2019-07-01 at 10 39 54 AM

Proposed solution

Similar to the text given in Step 3, I think it would be helpful for interns to have a checklist for each step. Where the text could say something along the lines of: "Once you complete Step #, you will have (1) (2) and (3)"

Liew211 commented 5 years ago

@hemu-codes In these steps, the only real deliverables are the issues and pull requests, so I don't think having such a checklist beyond what already exists is necessary.

hemu-codes commented 5 years ago

@Liew211 I guess rather than saying a checklist, a better way to put it is providing a quick summary of what you did in that particular step. This way, in the future, if you forget how to do a certain task, you don't have to spend too much time trying to figure out which step you can go to so that you can remind yourself how to do that task.

Liew211 commented 5 years ago

@hemu-codes Ah I see. Please make a sample of what you think should be added (in a comment here), and we can go from there.

hemu-codes commented 5 years ago

I was thinking something like this:

Summary of Step 1: By the end of this step, you should know how to set up your planet community on the command line/terminal, creating your planet learning account and learning about the different commands that will be used on the terminal for working with vagrant.

Liew211 commented 5 years ago

@hemu-codes I think that would be pretty good to add, go ahead with this.

aasenomad commented 5 years ago

@hemu-codes I like the idea too. that is a good idea.

saraive16 commented 5 years ago

I like the idea of a summary just to make sure nothing is missed.

pattanawadee88 commented 5 years ago

I think this is a good idea because people could read a summary, so they know what exactly they are doing.

smitshrestha101 commented 5 years ago

This is a great idea. Could make things so much easier.

nvrqt03 commented 5 years ago

I think it might also be helpful to know what steps we may need to do every day moving forward.

sauravghosal commented 5 years ago

I really like this idea. I found myself often getting confused and lost in the words of the tutorial - I feel like a quick summary/checklist after each step would make it easier to keep track of what I'm doing.

rheam97 commented 2 years ago

I think this idea is still needed because i find myself wondering if I've missed information at step 8.

lmmrssa commented 2 years ago

@rheam97 there is a note at end of step 8 which is the checklist which you should have completed by end of step 8

image
G201021 commented 3 weeks ago

This addition will actually make it more manageable, especially for very new users who are still getting around these other technologies. Could make task completion more tolerable