نظرثانی کا موازنہ کریں
Create a new Knowledge Base article
نظر ثانی 182460؛
Revision 182460 by AliceWyman on
نظر ثانی 228164؛
Revision 228164 by kelimuttu on
کلیدی الفاظ:
تلاش کے نتائج کا خلاصہ:
Guidelines and a template for creating a new article.
Guidelines and a template for creating a new article.
مواد:
To create a new article, right-click and open '''[https://support.mozilla.org/en-US/kb/new this link]''' in a new tab. The ''Create a New Knowledge Base Article'' page will open. Here's what the top part of that page looks like:
;[[Image:ArticleDescription]]
Don't be intimidated by all of the fields and checkboxes that you see when you first create a new article. Most everything can be handled later. This is all you really have to do:
#Enter a '''title''' (can be changed later). More on article titles [[Write articles for the Knowledge Base#w_title|here]].
#Choose the product this article is '''relevant to''' (can be changed later).
#Choose one '''topic''' (can be changed later).
#Enter a '''search result summary''' (short description of the article).
#Go to the '''Content''' box and start writing!
#;[[Image:content-box]]
#Click {button Preview Content} to see what your article will look like when it’s been published.
#When you’re satisfied with your article's content and appearance, click {button Submit for Review}.
#'''Briefly describe your changes''' in the Submit your Changes box that appears. If you have more work to do, you can type in "Work in progress". If you're ready for feedback and review, you can type in "Ready for review".
#;[[Image:Submit article]]
#Press {button Submit}.
The code below is an example of how text might appear in in the '''content''' section of an article, using the most common wiki markup. For an explanation of common markup used in KB articles, see the [[Markup cheat sheet]]. For lots more markup, see the [[Markup chart]].
<code>
Introduction goes here.
<br><br>
<nowiki>__TOC__</nowiki>
<br><br>
<nowiki>=First section=</nowiki><br>
An unordered list:<br>
<nowiki>*</nowiki>First item. For more information, see <nowiki>[[</nowiki>Name of article<nowiki>]]</nowiki><br>
<nowiki>*</nowiki><nowiki>[[</nowiki>Name of article|Second item<nowiki>]]</nowiki><br>
<nowiki>*:[[</nowiki>Image:Name of image<nowiki>]]</nowiki><br><br>
<nowiki>{</nowiki>note<nowiki>}</nowiki><nowiki>'''</nowiki>Note:<nowiki>'''</nowiki> This is an example of a note.<nowiki>{</nowiki>/note<nowiki>}</nowiki>
<br><br>
<nowiki>=Second section=</nowiki><br>
<nowiki>{</nowiki>for win<nowiki>}</nowiki><br>
A numbered list only "for" Windows users:<br>
<nowiki>#</nowiki>First item<br>
<nowiki>#</nowiki>Second item<br>
<nowiki>{</nowiki>/for<nowiki>}</nowiki><br><br>
<nowiki>{</nowiki>for mac<nowiki>}</nowiki><br>
A numbered list only "for" Mac users:<br>
<nowiki>#</nowiki>First item<br>
<nowiki>#</nowiki>Second item<br>
<nowiki>{</nowiki>/for<nowiki>}</nowiki><br><br>
<nowiki>{</nowiki>for linux<nowiki>}</nowiki><br>
A numbered list only "for" Linux users:<br>
<nowiki>#</nowiki>First item<br>
<nowiki>#</nowiki>Second item<br>
<nowiki>{</nowiki>/for<nowiki>}</nowiki><br><br>
<nowiki>{</nowiki>warning<nowiki>}</nowiki><nowiki>'''</nowiki>Warning:<nowiki>'''</nowiki> This is an example of a warning.<nowiki>{</nowiki>/warning<nowiki>}</nowiki>
</code>
= Article writing documentation =
If you're interested in writing articles for Mozilla Support, here are some resources that should help explain how we do things:
*'''[[About the Knowledge Base]] '''— is an overview of the mechanics of our Knowledge Base (for example, prioritization and scheduling).
*'''[[Write articles for the Knowledge Base]]''' — is a guide to writing techniques that make articles more engaging and effective. This article includes our [[Write articles for the Knowledge Base#w_style-guide-and-copy-rules|style guide and copy rules]].
*'''[[Improve the Knowledge Base]]''' — is our guide for new contributors. This article contains a [[Improve the Knowledge Base #w_complete-list-of-article-writing-documentation|complete list of article-writing documentation]].
To create a new article, right-click and open '''[https://support.mozilla.org/en-US/kb/new this link]''' in a new tab. The ''Create a New Knowledge Base Article'' page will open. Here's what the top part of that page looks like:
;[[Image:ArticleDescription]]
Don't be intimidated by all of the fields and checkboxes that you see when you first create a new article. Most everything can be handled later. This is all you really have to do:
#Enter a '''title''' (can be changed later). More on article titles [[Write articles for the Knowledge Base#w_title|here]].
#Choose the product this article is '''relevant to''' (can be changed later).
#Choose one '''topic''' (can be changed later).
#Enter a '''search result summary''' (short description of the article).
#Go to the '''Content''' box and start writing!
#;[[Image:content-box]]
#Click {button Preview Content} to see what your article will look like when it’s been published.
#When you’re satisfied with your article's content and appearance, click {button Submit for Review}.
#'''Briefly describe your changes''' in the Submit your Changes box that appears. If you have more work to do, you can type in "Work in progress". If you're ready for feedback and review, you can type in "Ready for review".
#;[[Image:Submit article]]
#Press {button Submit}.
The code below is an example of how text might appear in in the '''content''' section of an article, using the most common wiki markup. For an explanation of common markup used in KB articles, see the [[Markup cheat sheet]]. For lots more markup, see the [[Markup chart]].
<code>
Introduction goes here.
<br><br>
<nowiki>__TOC__</nowiki>
<br><br>
<nowiki>=First section=</nowiki><br>
An unordered list:<br>
<nowiki>*</nowiki>First item. For more information, see <nowiki>[[</nowiki>Name of article<nowiki>]]</nowiki><br>
<nowiki>*</nowiki><nowiki>[[</nowiki>Name of article|Second item<nowiki>]]</nowiki><br>
<nowiki>*:[[</nowiki>Image:Name of image<nowiki>]]</nowiki><br><br>
<nowiki>{</nowiki>note<nowiki>}</nowiki><nowiki>'''</nowiki>Note:<nowiki>'''</nowiki> This is an example of a note.<nowiki>{</nowiki>/note<nowiki>}</nowiki>
<br><br>
<nowiki>=Second section=</nowiki><br>
<nowiki>{</nowiki>for win<nowiki>}</nowiki><br>
A numbered list only "for" Windows users:<br>
<nowiki>#</nowiki>First item<br>
<nowiki>#</nowiki>Second item<br>
<nowiki>{</nowiki>/for<nowiki>}</nowiki><br><br>
<nowiki>{</nowiki>for mac<nowiki>}</nowiki><br>
A numbered list only "for" Mac users:<br>
<nowiki>#</nowiki>First item<br>
<nowiki>#</nowiki>Second item<br>
<nowiki>{</nowiki>/for<nowiki>}</nowiki><br><br>
<nowiki>{</nowiki>for linux<nowiki>}</nowiki><br>
A numbered list only "for" Linux users:<br>
<nowiki>#</nowiki>First item<br>
<nowiki>#</nowiki>Second item<br>
<nowiki>{</nowiki>/for<nowiki>}</nowiki><br><br>
<nowiki>{</nowiki>warning<nowiki>}</nowiki><nowiki>'''</nowiki>Warning:<nowiki>'''</nowiki> This is an example of a warning.<nowiki>{</nowiki>/warning<nowiki>}</nowiki>
</code>
= Complete Knowledge Base Guidelines =
If you're interested in editing and writing documentation, here are a few resources that should help explain how we do things:
'''Create new support articles'''
* [[Write articles for the Knowledge Base]] — Guide to writing techniques and styles that we use to make articles more engaging and effective. For the mechanics of actually creating or editing articles, see:
** '''[[Create a new Knowledge Base article]] – Steps for creating a new article along with some sample wiki markup to get you started (You're here!)'''
** [[Anatomy of a Knowledge Base article]] – Explains the basics of how articles are built
** [[Article Description]] - Explains how to write description for a support article
'''Improve existing support articles'''
* [[Improve the Knowledge Base]] - Learn how to improve SUMO Knowledge Base
* [[Edit a Knowledge Base article]] - Steps for editing an existing article
'''Other guidelines'''
* [[About the Knowledge Base]] — An overview of the mechanics of our Knowledge Base
* [[Article Review Guidelines]] - Reviewer guidelines for Knowledge Base
* [[How to make screenshots]] — A step-by-step guide to creating screenshots to use in articles
* [[Adding screenshots]] — Explains how to add screenshots to articles
* [[How to place images in an article]] — Explains how to get screenshots and other images to display correctly in articles
* [[Markup cheat sheet]] – The most commonly used wiki markup in our articles
* [[Markup chart]] — Wiki markup reference. It gives examples and shows the markup that produces them
* [[How to use For|How to use <nowiki>{</nowiki>for}]] — Special wiki markup that lets us show instructions ''for'' different application versions (for example, Firefox 40) and operating systems such as Windows and Mac OS
* [[Using Templates]] — Templates are reusable pieces of content. You can include a complicated set of step-by-step instructions in multiple articles by using a template.
* [[When and how to use keywords to improve an article's search ranking]] — Explains when adding keywords to an article is appropriate
* To see more guidelines on Knowledge Base contribution, click [https://support.mozilla.org/en-US/products/contributor/support-articles here]