Address certification feedback

[barbeau]

Below is feedback from the Alexa certification team that we need to address before public launch (which requires another submission to certification with the below items resolved). I opened a WIP PR at https://github.com/OneBusAway/onebusaway-alexa/pull/64 with individual commits to address the below items, and will check them off as they are addressed.

---

Requirements:

• [x] The invocation name you have chosen for your skill does not follow all conventions for choosing a name and is unlikely to have high accuracy for launching your skill. Please change your invocation name to "one bus away". For more information on invocation name guidelines, please visit: https://developer.amazon.com/appsandservices/solutions/alexa/alexa-skills-kit/docs/choosing-the-invocation-name-for-an-alexa-skill
• [x] The AMAZON.US_CITY slot type only includes cities with a population of over 100,000. You should expand the AMAZON.US_CITY slot type and include the following as slot values:

rogue valley york york region tampa bay puget sound san diego m. t. s.

Additionally, consider adding any other city/area name variation that you think users might say. For more information on expanding built-in slot types, please visit: https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-interaction-model-reference#Extending%20a%20Built-in%20Slot%20Type%20with%20Custom%20Values

• [x] An error occurs when saying the second example phrase. The example phrases must function without error since these are interactions that users are most likely to try. Please see test case 3.1 from our Submission Checklist for guidance on example phrases. Request ID: amzn1.echo-api.request.360a5f86-9117-4dcc-80eb-c6c2a98fb6c1
• [x] The skill does not exit/respond appropriately when users say “stop” or “cancel”. Please see test case [4.13 from our Submission Checklist](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-voice-interface-and-user-experience-testing#4.13. Intent %28Exit%29) for guidance on skill exiting.

Recommendations:

• [x] We recommend adding the following sample utterance as it is likely that users will respond to the stop ID prompt with only the stop number:

SetStopNumberIntent {stopNumber}

• [x] Errors in the tokenization of acronyms and initialisms can greatly impact the speech recognition for your skill. All instances of "id" should be changed to "i. d.".
• [x] The skill will work best for users when you include utterances that can easily work on their own, as well as utterances that work well to follow the one-shot launch phrasing. Consider adding the following types of sample utterances:

Commands (Work well after "ask onebusaway to..." or "tell onebusaway to...")

GetCityIntent get my current city GetCityIntent tell me my current city GetStopNumberIntent tell me what my stop is GetArrivalsIntent get me arrival times etc.

Noun Phrases (Work well after "ask onebusaway for...")

GetCityIntent my current region GetCityIntent my city GetStopNumberIntent my current stop GetStopNumberIntent my stop GetArrivalsIntent the arrival times of my {TransitMode} GetArrivalsIntent {TransitMode} times etc.

Interrogative and Inverted Questions (Work well after "ask onebusaway...")

GetArrivalsIntent where's my {TransitMode} GetArrivalsIntent where {TransitMode} is GetStopNumberIntent what's my current stop GetStopNumberIntent what my stop is GetCityIntent what's my city GetCityIntent what my city is etc.

[barbeau]

Alright, most of these have been pretty easy. Only one left related to adding more utterances. We're going to have to be careful with this one due to https://github.com/OneBusAway/onebusaway-alexa/issues/12 - I already had to remove the following two utterances in https://github.com/OneBusAway/onebusaway-alexa/commit/021279e27e1681998d3b1fa682832578b2aa53fc that were preventing it from correctly hearing "Atlanta":

GetArrivalsIntent the arrivals
GetArrivalsIntent for arrivals

So I want to test the recommended utterances to make sure we're not giving up recognition of any cities.

[barbeau]

Alright, just knocked off the last comment re: utterances. I'm now going to test and see if everything still works correctly.