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.

Sign up for GitHub

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

Planet Tutorial Wording and Clarification Improvements for Step 4 (fixes #2519) #2521

Closed
wants to merge 4 commits into from
Closed

Planet Tutorial Wording and Clarification Improvements for Step 4 (fixes #2519) #2521

Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
df0cb11
Planet Tutorial Wording and Clarification Improvements for Step 4 (fi…
johnmdrake1 Jul 7, 2019
c8326a5
Fixed spelling of preferred as per @ChiragAwale request
johnmdrake1 Jul 8, 2019
e9355a6
Fixed spelling of preferred, somehow had a spelling mistake again but…
johnmdrake1 Jul 8, 2019
eccd877
Made clarification about screenshots portion of question.
johnmdrake1 Jul 15, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 19 additions & 19 deletions pages/vi/vi-planetapps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,28 +1,28 @@
# Planet Tutorial
# Planet Tutorial

## Objectives

* Understand how Planet interface is structured
* Understand basic functions of community Planet
* Understand how the Planet interface is structured
* Understand basic functions of Community Planet
* Add resources to your Community in order to get accustomed to the Planet interface

## Preparation
Please go to http://localhost:3100 or run `vagrant global-status` in the command line to see if your community Planet is currently running. If not, please `cd` into `planet` directory in your local machine and run `vagrant up prod`.
Please go to http://localhost:3100 or run `vagrant global-status` in the command line to see if your community Planet is currently running. If not, please `cd` into the `planet` directory on your local machine and execute `vagrant up prod`.

Do not forget to send the screenshot of your Planet community configurations ([from the earlier step when you registered your configurations](vi-configurations-vagrant.md)) to our chat. In case you forgot to take the screenshot of your configurations, login to Planet, click on manager settings (top bar person with gear icon), click on the configuration button, take a screenshot of the page, and send it to the Gitter chat.
Do not forget to send the screenshot of your Planet community configurations ([from the earlier step when you registered your configurations](vi-configurations-vagrant.md)) to our chat, if you have not already done so. In case you forgot to take the screenshot of your configurations, login to Planet, click on manager settings (top bar icon with person and gear), click on the configuration button, take a screenshot of the page, and send it to the Gitter chat. If you had to destroy and create a new planet with a different name and configuration because of an error, screenshot your new configuration page and post it to the Gitter chat, otherwise your new Community will not be registered. If the commands above were sufficient and everything is working properly so far, there is no need to send another screenshot.

![Clicking on "Manager"](images/edit-vi-nation-manager.png "Dashboard in your localhost")

## Watch Videos

Watch the videos below to learn the basic functions of your Planet. These videos were created a few years ago, on old system BeLL but they should do a decent job of introducing you to the Planet.
Watch the videos below to learn the basic functions of your Planet. These videos were created a few years ago, on an old system, BeLL, but they should do a decent job of introducing you to the Planet.

[My Dashboard](movies/vi-mydashboard.mp4)
[Library](movies/vi-library.mp4)
[Feedback](movies/vi-feedback.mp4)
[Generating Activity Reports](movies/vi-generatingactivityreports.mp4)

We suggest you to play around a bit, try to explore and feel comfortable with Planet.
We suggest you play around with your Planet interface a bit, and try to explore so you can feel more comfortable with Planet.

## Upload Resources

Expand All @@ -40,23 +40,23 @@ Next, go to [your community Planet](http://localhost:3100). Select `Library` fro

Fill out the information:

1. Fill in all of the text boxes and drop-down menus (As this is just practice, accuracy of information is not important)
2. Be sure to **upload** one of the `PDF - "Feelings"`, `mp3 song - "Opposite Song"`, or `mp4 video - "Burka Avenger"` files.
1. Fill in all of the text boxes and drop-down menus (As this is just practice, accuracy of information is not important, just make sure the Open dropdown corresponds with the appropriate media type).
2. Be sure to **upload** one of the `PDF - "Feelings"`, `mp3 song - "Opposite Song"`, or `mp4 video - "Burka Avenger"` files using the button to the right of **File Upload**.
3. Next, click on Submit. You have now uploaded the resource.
4. Find the resources in `Library`, and make sure that you can open it.
4. Find the newly uploaded resources in `Library`, and make sure that you can open each of them.
5. Repeat this until all three files have been uploaded as resources.

## Different Kinds of Updates to Your Community

There are three important kinds of updates that you may receive on the community side: upgrades, resources/courses and sync. Go to your Manager page and search for the buttons highlighted in the picture below. You may not see the `Fetch Items` button if nation has not sent anything to the community. If you do not see the other two highlighted buttons, post a message to the Gitter Chat channel to get help.
There are three important kinds of updates that you may receive on the Community side of your Planet: upgrades, resources/courses and sync. Go to your Manager page and search for the buttons highlighted in the picture below. You may not see the `Fetch Items` button if the nation has not sent anything to the community. If you do not see the other two highlighted buttons, post a message to the Gitter Chat channel to get help.

As you can see from the image below, there is an upgrade ready to be downloaded. Usually, next to the upgrade, you should also see publication(s) (we send to you from the nation) ready to be downloaded.

![Update from the nation](images/vi-planet-upgrade.png "Manager Dashboard in your localhost")
![Fetch Items from the nation](images/vi-planet-fetch-items.png "Manager Dashboard in your localhost")

1. Click the `Upgrade` button on Manager page and it take you to upgrade page. An upgrade refers to a software update which improves the Planet (Note: If you do not see `Upgrade` button then simply carry on). It will then ask you for verification.
2. After the upgrade is complete, undergo `vagrant halt prod` and `vagrant up prod` to restart planet.
1. Click the `Upgrade` button on Manager page and it will take you to the upgrade page. An upgrade refers to a software update which improves the Planet (Note: If you do not see the `Upgrade` button then simply carry on). It will then ask you for verification.
2. After the upgrade is complete, execute the `vagrant halt prod` and `vagrant up prod` commands to restart Planet.
3. If `Fetch Items` is available on the Manager page, click on it and download the courses offered (2nd picture).
4. Finally, send an activities sync to the nation using `Manage Sync`.

Expand All @@ -66,15 +66,15 @@ As you can see from the image below, there is an upgrade ready to be downloaded.

## Take the Course

We created a course for aspiring virtual interns so that we could test the software used to build courses and find bugs/things to improve. It is your job to take the course and find out what needs to be fixed/improved from the student standpoint.
We created a course for aspiring virtual interns so that we could test the software used to build courses and find bugs and other things that need improvement. It is your job to take the course and find out what needs to be fixed and/or improved from the student standpoint.

Take the course, and the last question will ask you to specify any problems or improvements/suggestions that you have. Remember, people taking these courses in remote areas of the world will probably run into the same problems if you do not raise them now and let the team know. This is a very important task, and your help is much appreciated.
Take the course. The last question will ask you to specify any problems you had while taking the course along with any improvements/suggestions that you may have. Remember, people taking these courses in remote areas of the world will probably run into the same problems if you do not raise them now and let the team know of their presence. This is a very important task, and your help is very much appreciated.

**STEPS:**

1. Click on `Courses` on the top navigation
2. Find the course "Virtual Interns", select checkbox next to course and then click on `Join`
3. Click on Course to `Open`
2. Find the course "Virtual Interns", select the checkbox next to the course, and then click on `Join`
3. Click on the Course to `Open`
4. Carefully finish all steps of the course

![Finished Planet Course](images/vi-planet-course.jpg)
Expand All @@ -84,12 +84,12 @@ Take the course, and the last question will ask you to specify any problems or i
![Submissions button](images/vi-planet-submissions-button.png)
![View Submissions](images/vi-planet-submissions.png)

6. When you provide feedback, try to be as specific as possible, and include screenshots when necessary
6. When you provide feedback, try to be as specific as possible, and include screenshots when necessary, through your preferred method (Gitter chat is always a great fallback if you are not comfortable with uploading and linking screenshots).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@johnmdrake1 can you explain this statement? Are you trying to say you should upload screenshot or saying not to use gitter if you are not familiar with that feature?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When I was taking the planet course, there was nowhere I saw in the free response feedback question to upload a photo or screenshot, I checked the toolbar at the top of the text entry field for an attachment button and didn't see one unless I missed it. I personally uploaded my screenshots to Imgur, and made a private Imgur link to my album which I put in my answer to question 12. Not everyone may know how to use screenshot sharing websites such as Imgur, so I was saying use Gitter if you don't know another way. If there is a preferred image hosting site OLE would like Virtual Interns to use for that question that should go there instead.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Immrssa

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@leomaxi comes up, if that's your tag my apologies

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lmmrssa

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lillyxxx completely agreed. Thoughts @lmmrssa So I can get this issue and pull request sorted out?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@johnmdrake1 @lillyxxx as mentioned planet does not have way to upload image on exam. If question is confusing we can change the question which is not part of this repository.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, in my opinion that is what should be done. On my end, should I take out my addition about how to upload images on the exam, and the Planet team can change the question in the appropriate repository? @lmmrssa

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lmmrssa is this better?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(see most recent commit)


![Take the Course](images/vi-take-the-course.png)
![Course Overview](images/vi-course-view.png)

If the course "Virtual Interns" is not there, check `Manage Sync` of manager settings page to see if your synchronization are completed. Otherwise please message us and "@" an admin in the Gitter chat so we can send you the course manually.
If the course "Virtual Interns" is not there, check `Manage Sync` on the Manager settings page to see if your synchronization(s) are completed. Otherwise please message us and "@" an admin in the Gitter chat so we can send you the course manually.

## Useful Links

Expand Down