-
Notifications
You must be signed in to change notification settings - Fork 264
[Docs] - README.md - minor tweaks #1157
base: master
Are you sure you want to change the base?
Conversation
[Docs] - README.md - minor tweaks tweak number 1 - separators
fix number two - ortography (minor tweaks)
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 |
now - adding tables of content - please don't merge yet |
adding Table of Contents (ToC)
now adding thumbnails |
adding thumbnail
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. |
There was a problem hiding this comment.
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). |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"recipient"? https://openbadgespec.org/#recipient
There was a problem hiding this comment.
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! ;)
[Docs] - README.md - minor tweaks
tweak number 1 - separators - adding separators before every single h2 tag (##)