# Create a Knowledge Base Article

We want our knowldege base to be organized and structured. Below is the outline to follow when creating your knowledge base articles.

_Search_

- Article #1 (Structure continues to each article)
  - Scenario
    - This is where we’d describe a use case
  - Problem
    - This is where we’d explain the problem or issue faced
  - Troubleshooting
    - Steps go here
  - Solution/Workaround
    - The good stuff
  - Additional info
    - Known issue link /Bug fix link etc

_Code Insights_

- Article #1 (Structure continues to each article)
  - Scenario
    - This is where we’d describe a use case
  - Problem
    - This is where we’d explain the problem or issue faced
  - Troubleshooting
    - Steps go here
  - Solution/Workaround
    - The good stuff
  - Additional info
    - Known issue link /Bug fix link etc

_Code Intelligence_ (SAME AS ABOVE)

_Batch Changes_ (SAME AS ABOVE)


<section class="h0Wrapper headingWrapper"><section class="h1Wrapper headingWrapper"><h1 id="create-a-knowledge-base-article"><a class="anchor" aria-hidden tabindex="-1" href="#create-a-knowledge-base-article"><span class="icon icon-link"></span></a>Create a Knowledge Base Article</h1>
<p>We want our knowldege base to be organized and structured. Below is the outline to follow when creating your knowledge base articles.</p>
<p><em>Search</em></p>
<ul>
<li>Article <a href="https://github.com/sourcegraph/sourcegraph/issues/1">#1</a> (Structure continues to each article)
<ul>
<li>Scenario
<ul>
<li>This is where we’d describe a use case</li>
</ul>
</li>
<li>Problem
<ul>
<li>This is where we’d explain the problem or issue faced</li>
</ul>
</li>
<li>Troubleshooting
<ul>
<li>Steps go here</li>
</ul>
</li>
<li>Solution/Workaround
<ul>
<li>The good stuff</li>
</ul>
</li>
<li>Additional info
<ul>
<li>Known issue link /Bug fix link etc</li>
</ul>
</li>
</ul>
</li>
</ul>
<p><em>Code Insights</em></p>
<ul>
<li>Article <a href="https://github.com/sourcegraph/sourcegraph/issues/1">#1</a> (Structure continues to each article)
<ul>
<li>Scenario
<ul>
<li>This is where we’d describe a use case</li>
</ul>
</li>
<li>Problem
<ul>
<li>This is where we’d explain the problem or issue faced</li>
</ul>
</li>
<li>Troubleshooting
<ul>
<li>Steps go here</li>
</ul>
</li>
<li>Solution/Workaround
<ul>
<li>The good stuff</li>
</ul>
</li>
<li>Additional info
<ul>
<li>Known issue link /Bug fix link etc</li>
</ul>
</li>
</ul>
</li>
</ul>
<p><em>Code Intelligence</em> (SAME AS ABOVE)</p>
<p><em>Batch Changes</em> (SAME AS ABOVE)</p></section></section>