update troubleshooting docs (circleci#8913)

* Update pipelines.adoc

* move troubleshooting to snippet and add whole snippet to pipelines page

---------

Co-authored-by: Rosie Yohannan <[email protected]>

Author: sebastian-lerner

jekyll/_cci2/pipelines.adoc

@@ -170,6 +170,11 @@ image::/docs/assets/img/docs/vs_code_extension_job-details.png[Screenshot showin
 
 The CircleCI VS Code extension is available to download on the link:https://marketplace.visualstudio.com/items?itemName=circleci.circleci[VS Code marketplace.]
 
+[#troubleshooting]
+== Troubleshooting
+
+include::../_includes/snippets/troubleshoot/pipelines-troubleshoot-snip.adoc[]
+
 [#next-steps]
 == Next steps
 

jekyll/_includes/snippets/troubleshoot/pipelines-troubleshoot-snip.adoc

@@ -1,3 +1,18 @@
+=== Config could not be located error
+
+If you see the following error message, check the steps below to remediate the issue.
+
+[,shell]
+----
+config file .circleci/sample-filename.yml could not be located on branch sample-branch-name in repository sample-repo-name
+----
+
+* Ensure that there is a CircleCI configuration file in the repository on the branch that uses the filename specified in the error message. If there is not one present, add a CircleCI configuration file.
+
+* If there is a config file present:
+.. Navigate to menu:Project Settings[Pipelines] in the CircleCI web app for the project where you are seeing this error message.
+.. Select the pencil icon for each pipeline listed and ensure that the "Config File Path" field matches the filepath of the config file that is in your repository. If you changed the name of the config file in your repository, the reference to that filepath must also be changed in the menu:Project Settings[Pipelines] section for any pipeline that uses that configuration file.
+
 [#why-is-my-scheduled-pipeline-not-running]
 === Why is my scheduled pipeline not running?
 
@@ -22,9 +37,9 @@ After checking your `.circleci/config.yml` for formatting errors, search for you
 A job might end up being queued because of a concurrency limit being imposed due your organization's plan. If your jobs are queuing often, you can consider link:https://circleci.com/pricing/[upgrading your plan].
 
 [#why-are-my-jobs-queuing-performance-plan]
-=== Why are my jobs queuing even though I am on the Performance plan?
+=== Why are my jobs queuing even though I am on the Performance Plan?
 
-In order to keep the system stable for all CircleCI customers, we implement different soft concurrency limits on each of the xref:configuration-reference#resourceclass[Resource classes]. If you are experiencing queuing on your jobs, it is possible you are hitting these limits. Please link:https://support.circleci.com/hc/en-us/requests/new[contact CircleCI support] to request raises on these limits.
+In order to keep the system stable for all CircleCI customers, we implement different soft concurrency limits on each of the xref:configuration-reference#resourceclass[Resource classes]. If you are experiencing queuing on your jobs, it is possible you are hitting these limits. link:https://support.circleci.com/hc/en-us/requests/new[Contact CircleCI support] to request raises on these limits.
 
 [#find-project-projects-dashboard]
 === Why can I not find my project on the Projects dashboard?
@@ -36,13 +51,15 @@ If you are not seeing a project you would like to build, and it is not currently
 
 CircleCI currently supports pulling (and pushing with Docker Engine) Docker images from link:https://hub.docker.com/[Docker Hub]. For link:https://hub.docker.com/explore/[official images], you can pull by simply specifying the name of the image and a tag:
 
+[,yml]
 ----
 golang:1.7.1-jessie
 redis:3.0.7-jessie
 ----
 
 For public images on Docker Hub, you can pull the image by prefixing the account or team username:
 
+[,yml]
 ----
 my-user/couchdb:1.6.1
 ----