search

alexa-samples / skill-sample-nodejs-adventure-game

This tool provides an easy to use front-end that allows developers to instantly deploy code for your story, or use the generated code as a starting point for more complex projects.
Apache License 2.0
510 stars 218 forks source link

Great Tool. Minor Suggestions for Tutorial #46

Open jasonnmark opened 6 years ago

jasonnmark commented 6 years ago

As a noob I found the directions mostly amazing. Below are some spots I stumbled and quick suggestions to fix:

3 "Create an AWS Role..." - Suggest adding "see screenshots below" to end of this line. I stumbled for a little thinking the picture was for step 4 and ignoring it.

4 Add "Click on the Services Menu and choose Lambda, then create an AWS..."

5 Probably redundant once someone figures out #4, but still saying "Click on the Services menu and choose DynamoDB" at beginning

7 I think the button was called "Alexa Skill Kit" not "create Alexa skill". Figured it out and minor compared to others but might be worth changing the wording slightly to say "Create an alexa skill kit named.."

7 (part II) - it would be great if your screenshot had a sample ARN in there I copy pasted way to many words from the top right above and had a bit of trial and error. Seeing one in action would have made it simple to figure out where to truncate.

SET UP YOUR MACHINE

2 I spent about 30 minutes bumping around this one. Might have gotten it working. Would be great to point to a tutorial on this or breaking it into a couple of steps. This was super confusing as a noob.

3 Probably worth noting that Xcode is required. I tried and failed a few times before coming across this.

Thanks again for all the great work, and the detailed read-me!

uxjesi commented 6 years ago

I am also hopelessly lost on the "setup your machine" part. :/ I understand this is not necessarily a process aimed at n00bs, and therefore the instructions assume a certain amount of base knowledge, however, just listing basic requirements for the setup your machine part would be nice. E.G. You'll need xCode, or be able to use terminal etc. These are great suggestions! :)

samdobson commented 6 years ago

Hi both!

There is certainly room for improvement on the documentation front. I'm working on bringing it up to date and adding more detail around the more tricky pieces.

Also conducting initial experiments into building a hosted service around this tool, opening up the world of Alexa Skill creation to non-coders :slightly_smiling_face: