Skip to content
This repository has been archived by the owner on Dec 24, 2021. It is now read-only.

Suggestions to Improve Run Locally Instructions #83

Open
madisongong opened this issue Jul 24, 2018 · 0 comments
Open

Suggestions to Improve Run Locally Instructions #83

madisongong opened this issue Jul 24, 2018 · 0 comments

Comments

@madisongong
Copy link

  1. Clone the repo
    -Cloning the repository is straightforward, instructions tell you exactly what to do
    -But what if the person doesn't know what a terminal is? What if they are just starting out with coding, maybe should offer an explanation or recommendation on where to go for more information?

  2. Create IBM Cloud services
    -Watson Discovery: Process is clear, but free IBM Cloud account only lets you create so many services, so that could be an issue.
    -Cloudant NoSQL DB: See later suggestions

  3. Configure Watson Discovery and get credentials
    -Launching and choosing Watson Discovery News from the Manage Data tab is clear.
    -Found Environment ID ok as well, but maybe explain what a .env file?
    -Looked at youtube video tutorial for help, followed along to get to the credentials on terminal.
    -No clear written instructions on how to get .env file and how to edit it - maybe add something to further clarify?

  4. Provision Cloudant NoSQL DB and Get Credentials
    -Navigated to console.bluemix.net and searched for cloudant nosql, but 3 results came up, not 1.
    -Not listed under data & analytics section.

  5. Web Portal
    -Not quite why these instructions are here, why is it important to have the repository of the template of the website?

  6. Add IBM Cloud Services Credentials to .env file
    -Clear on how to get the credentials, but to replace the credentials to the .env file, need to know how to use the vi text editor
    -Where do you exactly save the file on the computer?

  7. Run the application
    -Need to have downloaded Node.js and npm, steps just tell you to run "npm install" and "npm start" in root directory
    -^Should be a part of the prerequisites or add more instructions to step 7

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

No branches or pull requests

1 participant