Difference between revisions of "How do I create an article?"
The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.
| (18 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{Breadcrumb|en|Wie lege ich einen Artikel an?|Getting started}} | |
| − | {{ | ||
| − | |||
__TOC__ | __TOC__ | ||
| − | == First: | + | == First: Check it out== |
You should always make sure before you create a new article that the information is not already available in an existing article or described in a similar way. It may make more sense in this case to extend the existing article. | You should always make sure before you create a new article that the information is not already available in an existing article or described in a similar way. It may make more sense in this case to extend the existing article. | ||
| Line 10: | Line 8: | ||
To do this, choose [[Special:Search|search options]] to look for keywords in the new article being created. | To do this, choose [[Special:Search|search options]] to look for keywords in the new article being created. | ||
| − | If you still think it makes sense to create a new article on your topic despite the content being similar, create a link from the existing article to your new article, for example: "For further information, see [[#First: | + | If you still think it makes sense to create a new article on your topic despite the content being similar, create a link from the existing article to your new article, for example: "For further information, see [[#First: Check it out|new article's name]]". |
| − | == How to | + | == How to Create a new Article == |
There are two typical methods for doing this: | There are two typical methods for doing this: | ||
| − | # You first edit an existing article or an appropriate overview page and then create an [[How do I link to other contents or URLs?#Internal_links|internal link]] from here to the article | + | # You first edit an existing article or an appropriate overview page and then create an [[How do I link to other contents or URLs?#Internal_links|internal link]] from here to the article you would like to create. Once you have saved the page, the link to the as yet unavailable article appears <span style="color:#ba0000; cursor:pointer" title="this is what a link to an as yet unavailable article looks like.">in red</span>. If you now click this link, the page for editing the new article will be opened directly. |
| − | # In the search field for articles, enter the title of an article you would like to create on the left hand side. If an article with this name does not yet exist, one of the options you will be offered on the hits page for the search is to create | + | # In the search field for articles, enter the title of an article you would like to create on the left hand side. If an article with this name does not yet exist, one of the options you will be offered on the hits page for the search is to create the new article. By clicking the relevant link, the page for editing the new article will be opened directly. |
The first method is recommended because it ensures that a link is already created to the new article. | The first method is recommended because it ensures that a link is already created to the new article. | ||
| − | == Article | + | == Article Titles == |
The following characters must not be used in titles: | The following characters must not be used in titles: | ||
| Line 27: | Line 25: | ||
" # $ * + < > = @ [ ] \ ^ ` { } | ~ | " # $ * + < > = @ [ ] \ ^ ` { } | ~ | ||
| − | The first character of the title must also not be | + | The first character of the title must also not be a forward slash "/". |
Wikis is case sensitive, which means that it distinguishes between uppercase and lowercase letters. Two titles, such as ''optiPoint'' and ''OptiPoint'', which only differ in terms of how the first letter is written, lead to different articles in this Wiki! | Wikis is case sensitive, which means that it distinguishes between uppercase and lowercase letters. Two titles, such as ''optiPoint'' and ''OptiPoint'', which only differ in terms of how the first letter is written, lead to different articles in this Wiki! | ||
| Line 34: | Line 32: | ||
Where proper names or abbreviations are used as article names, for example '''optiPoint''' or '''SIP''', use the suffix ''(de)'' to differentiate, therefore for example ''SIP (de)'' for the German article on SIP. | Where proper names or abbreviations are used as article names, for example '''optiPoint''' or '''SIP''', use the suffix ''(de)'' to differentiate, therefore for example ''SIP (de)'' for the German article on SIP. | ||
| − | == Structuring | + | == Structuring Content == |
Please refer to the following pages in this regard: | Please refer to the following pages in this regard: | ||
| Line 42: | Line 40: | ||
* [[How do I add images and multimedia?]] | * [[How do I add images and multimedia?]] | ||
| − | == Linking | + | == Linking Articles == |
| − | Wiki is characterized not just by its | + | Wiki is characterized not just by its content but also by its link structure. When creating a new article, it should on one hand be linked to a number of other pages and on the other hand it should contain cross-references, if it lends itself to this. See also: [[How do I link to other contents or URLs?]] |
| − | === | + | === Linking own Articles to other Pages === |
| − | A new article should in any case be linked | + | A new article should in any case be linked to an appropriate overview page. Such overview pages can be found below the entry-level navigation points [[Phones]], [[Platforms]], [[Your Assistance]], [[FAQ]], [[How To]], [[White Papers]] and [[Glossary]]. Don't be afraid to edit these pages and insert the link to your new article in the appropriate place. |
| − | + | Other articles frequently exist that refer to the topic dealt with in your own article. Take the trouble to edit the relevant article and insert a link to your new article at the appropriate position in the text. It may also be the case that your new article contains related or comparable information from the perspective of an existing article. In such a case, you can add a section for further information at the end of the other article, assuming the article does not already contain such a section. You can then place the link to your article here. | |
| − | === Creating | + | === Creating Links to other Pages in your own Article === |
| − | When editing your article text, remember that the article is not an isolated publication, rather must be looked at in the context of the Wiki. For example, you can link specialist terms or abbreviations that appear in the [[Glossary]]. Should it happen that a specialist term or abbreviation is | + | When editing your article text, remember that the article is not an isolated publication, rather must be looked at in the context of the Wiki. For example, you can link specialist terms or abbreviations that appear in the [[Glossary]]. Should it happen that a specialist term or abbreviation is not in the glossary, then simply create an appropriate article based on the template of the other glossary entries. |
| − | You can also create links to other pages, which contain additional or comparable information from the perspective of your article. A [[How To|How-to article]] for example can contain links to questions in the [[FAQ]], which relate to your content. Articles that portray experience with [[Phones|phones]] should link to the product page | + | You can also create links to other pages, which contain additional or comparable information from the perspective of your article. A [[How To|How-to article]] for example can contain links to questions in the [[FAQ]], which relate to your content. Articles that portray experience with [[Phones|phones]] should link to the product page for the respective device. |
| − | Users who are not altogether familiar with the information offering of this Wiki | + | Users who are not altogether familiar with the information offering of this Wiki may not be able to use these links as confidently yet in their own articles. One of the tasks of our experienced editors is therefore to rework articles that contain weak links. |
| − | == Tracking | + | == Tracking Changes and Discussions relating to the Article == |
If you have contributed an article, then you will no doubt also have an interest in checking whether the article is being edited by other users. It is therefore recommended to copy your own articles to your watchlist. The watchlist is available when you are logged in. | If you have contributed an article, then you will no doubt also have an interest in checking whether the article is being edited by other users. It is therefore recommended to copy your own articles to your watchlist. The watchlist is available when you are logged in. | ||
| Line 66: | Line 64: | ||
To add an article to the watchlist, open the article (not for editing, rather in the normal presentation view) and then click ''watch'' in the topline navigation. | To add an article to the watchlist, open the article (not for editing, rather in the normal presentation view) and then click ''watch'' in the topline navigation. | ||
| − | To see which articles you currently have in your watchlist, click ''my watchlist'' at the top | + | To see which articles you currently have in your watchlist, click ''my watchlist'' at the top of the page. You can also edit the watchlist here and remove entries from it that you no longer need. |
| − | As | + | As author of an article you should also track discussions on your contributions. If appropriate, make comments on the discussion contributions of other users. In order to access the discussion page for an article, call up the article in the normal presentation view and then click ''discussion'' in the topline navigation. |
Latest revision as of 07:33, 27 April 2011
|
You are here: |
 Home Getting started How do I create an article?
|
 Diese Seite auf Deutsch
|
Contents
First: Check it out
You should always make sure before you create a new article that the information is not already available in an existing article or described in a similar way. It may make more sense in this case to extend the existing article.
To do this, choose search options to look for keywords in the new article being created.
If you still think it makes sense to create a new article on your topic despite the content being similar, create a link from the existing article to your new article, for example: "For further information, see new article's name".
How to Create a new Article
There are two typical methods for doing this:
- You first edit an existing article or an appropriate overview page and then create an internal link from here to the article you would like to create. Once you have saved the page, the link to the as yet unavailable article appears in red. If you now click this link, the page for editing the new article will be opened directly.
- In the search field for articles, enter the title of an article you would like to create on the left hand side. If an article with this name does not yet exist, one of the options you will be offered on the hits page for the search is to create the new article. By clicking the relevant link, the page for editing the new article will be opened directly.
The first method is recommended because it ensures that a link is already created to the new article.
Article Titles
The following characters must not be used in titles:
" # $ * + < > = @ [ ] \ ^ ` { } | ~
The first character of the title must also not be a forward slash "/".
Wikis is case sensitive, which means that it distinguishes between uppercase and lowercase letters. Two titles, such as optiPoint and OptiPoint, which only differ in terms of how the first letter is written, lead to different articles in this Wiki!
The article name should always be in the language in which the content of the article is also written. Where proper names or abbreviations are used as article names, for example optiPoint or SIP, use the suffix (de) to differentiate, therefore for example SIP (de) for the German article on SIP.
Structuring Content
Please refer to the following pages in this regard:
- How do I format my contents?
- How do I link to other contents or URLs?
- How do I add images and multimedia?
Linking Articles
Wiki is characterized not just by its content but also by its link structure. When creating a new article, it should on one hand be linked to a number of other pages and on the other hand it should contain cross-references, if it lends itself to this. See also: How do I link to other contents or URLs?
Linking own Articles to other Pages
A new article should in any case be linked to an appropriate overview page. Such overview pages can be found below the entry-level navigation points Phones, Platforms, Your Assistance, FAQ, How To, White Papers and Glossary. Don't be afraid to edit these pages and insert the link to your new article in the appropriate place.
Other articles frequently exist that refer to the topic dealt with in your own article. Take the trouble to edit the relevant article and insert a link to your new article at the appropriate position in the text. It may also be the case that your new article contains related or comparable information from the perspective of an existing article. In such a case, you can add a section for further information at the end of the other article, assuming the article does not already contain such a section. You can then place the link to your article here.
Creating Links to other Pages in your own Article
When editing your article text, remember that the article is not an isolated publication, rather must be looked at in the context of the Wiki. For example, you can link specialist terms or abbreviations that appear in the Glossary. Should it happen that a specialist term or abbreviation is not in the glossary, then simply create an appropriate article based on the template of the other glossary entries.
You can also create links to other pages, which contain additional or comparable information from the perspective of your article. A How-to article for example can contain links to questions in the FAQ, which relate to your content. Articles that portray experience with phones should link to the product page for the respective device.
Users who are not altogether familiar with the information offering of this Wiki may not be able to use these links as confidently yet in their own articles. One of the tasks of our experienced editors is therefore to rework articles that contain weak links.
Tracking Changes and Discussions relating to the Article
If you have contributed an article, then you will no doubt also have an interest in checking whether the article is being edited by other users. It is therefore recommended to copy your own articles to your watchlist. The watchlist is available when you are logged in.
To add an article to the watchlist, open the article (not for editing, rather in the normal presentation view) and then click watch in the topline navigation.
To see which articles you currently have in your watchlist, click my watchlist at the top of the page. You can also edit the watchlist here and remove entries from it that you no longer need.
As author of an article you should also track discussions on your contributions. If appropriate, make comments on the discussion contributions of other users. In order to access the discussion page for an article, call up the article in the normal presentation view and then click discussion in the topline navigation.
