Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refactor troubleshooting by product, rather than by general scenario #1023

Open
jgwest opened this issue Jan 16, 2017 · 1 comment
Open

Refactor troubleshooting by product, rather than by general scenario #1023

jgwest opened this issue Jan 16, 2017 · 1 comment

Comments

@jgwest
Copy link

jgwest commented Jan 16, 2017

At present, troubleshooting items are not organized by product, but rather by general scenario, for example: 'Managing apps' or 'Accessing Bluemix' (from https://console.ng.bluemix.net/docs/troubleshoot/ts_apps.html#managingapps)

However, usually a customer is coming from a specific product/technology and looking for those answers, for example, they are using a buildpack (liberty/node), service (cloudant), or tools (Eclipse Tools for Bluemix/IBM Devops Services/CF CLI), rather than thinking in terms of whether their questions fits a specific scenario.

For example, under Managing Apps, it is true that many are general issues, but about half are product-specific (Bluemix DevOps services, Eclipse Tools for Bluemix, Node buildpack, IBM Push service, etc)

The current topic organization thus requires users to essentially search through all the topics for something that matches their specific issue, rather than getting product-specific troubleshooting.

A refactoring would thus look something like this (ordered by # of issues):
Managing Apps

  • General Issues
  • Bluemix DevOps services
  • Eclipse Tools for Bluemix
  • Node.js buildpack
  • IBM Push Service
  • etc
@Crystal4545
Copy link
Collaborator

Checked with Patrick about the plans for Support and Troubleshooting. He said that his focused writing areas are shifted to IAM. So @jenschlot it might be best to check with you. Pls suggest who is on point for the Support and Troubleshooting issues.

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

No branches or pull requests

2 participants