Skip to content
This repository has been archived by the owner on Aug 22, 2019. It is now read-only.

[Docs] - README.md - minor tweaks #1157

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

[Docs] - README.md - minor tweaks #1157

wants to merge 4 commits into from

Conversation

ghost
Copy link

@ghost ghost commented Dec 15, 2017

[Docs] - README.md - minor tweaks

tweak number 1 - separators - adding separators before every single h2 tag (##)

tiagomoraismorgado added 2 commits December 15, 2017 18:18
[Docs] - README.md - minor tweaks

tweak number 1 - separators
fix number two - ortography (minor tweaks)
@ghost
Copy link
Author

ghost commented Dec 15, 2017

please tell me whether the correct word is learner or earner. please feel free to give me more feedback, as long as it is constructive

@ghost
Copy link
Author

ghost commented Dec 15, 2017

now - adding tables of content - please don't merge yet

adding Table of Contents (ToC)
@ghost
Copy link
Author

ghost commented Dec 15, 2017

now adding thumbnails

adding thumbnail
@ghost
Copy link
Author

ghost commented Dec 15, 2017

i think it's everything for now

## What is the Backpack?

The Mozilla Backpack is a placed to store your collections of Open Badges. The Backpack allows earners to import badges and manage them in groups, choosing whether each group is public or not. You can access the Mozilla Backpack Web front-end at: http://backpack.openbadges.org

The Backpack code includes tools for badge issuers and displayers, for pushing awarded badges to an earner's Mozilla Backpack and for retrieving an earner's badges for display. If you're an issuer or displayer, you will find more information on how to start interacting with the Backpack at the bottom of this guide.
The Backpack code includes tools for badge issuers and displayers, for pushing awarded badges to an earner's Mozilla Backpack and for retrieving an earner's badges for display. If you're an issuer or displayed, you will find more information on how to start interacting with the Backpack at the bottom of this guide.
Copy link
Contributor

Choose a reason for hiding this comment

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

This should be displayer and not displayed

@@ -123,9 +143,9 @@ environment variable `NODE_ENV=production`. These differences include:

Heroku relies upon the [habitat](https://github.com/brianloveswords/habitat) environment variables loader library. The config for this can be found in [lib/environments/heroku.js](lib/environments/heroku.js).

When configuring your environment variables on heroku, they should be prefixed with the string that is passed to the habitat constructor. For example, if we pass the string "openbadges" to our habitat constructor, like so: `new Habitat("openbadges")`, then in heroku our protocol env var would be "OPENBADGES_PROTOCOL" (with, in this case, a value set to either http or https).
When configuring your environment variables on Heroku, they should be prefixed with the string that is passed to the habitat constructor. For example, if we pass the string "open badges" to our habitat constructor, like so: `new Habitat("open badges")`, then in Heroku our protocol env var would be "OPENBADGES_PROTOCOL" (with, in this case, a value set to either HTTP or https).
Copy link
Contributor

Choose a reason for hiding this comment

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

The string openbadges is acceptable and correct.

Also, if we uppercase HTTP we should probably uppercase HTTPS too.

## I'm an Issuer, how do I use this?

The Backpack includes the following tools for badge issuers:

* [Issuer API](docs/apis/issuer_api.md)
* For pushing badges you have awarded the earner to their Mozilla Backpack, giving the earner the ability to approve the push through a lightboxed modal. The API is written in Javascript, and is includable in your project with just a few lines of JS.
* For pushing badges you have awarded the earner to their Mozilla Backpack, giving the learner the ability to approve the push through a lightbox modal. The API is written in Javascript, and is includable in your project with just a few lines of JS.
Copy link
Contributor

Choose a reason for hiding this comment

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

Earner is the correct term.

Copy link

@ottonomy ottonomy May 23, 2018

Choose a reason for hiding this comment

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

Copy link
Contributor

Choose a reason for hiding this comment

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

@ottonomy Yeah, that is even better! ;)

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

Successfully merging this pull request may close these issues.

2 participants