How to Write WikiOD Tutorial
Search before you start a new tutorial. Since a wiki works best when there is only one page per topic, duplicate pages will be merged. Before starting a new article first search WikiOD. If your exact topic already exists, please edit the existing tutorial. You should feel free to make dramatic changes to existing tutorials in the spirit of improvement.
The following is a brief introduction to the standard tutorial format:
Title[edit | edit source]
Create a brief and accurate title. The title should be the most concise, most commonly searched way to describe the activity.
How to write[edit | edit source]
Introduction[edit | edit source]
Write a brief summary of the topic that invites your reader to continue reading. Ideally, this area should consist of about 40 to 70 words, but you can use more or less if necessary.
Steps[edit | edit source]
- Understand that the steps constitute the main body of your instructions. When possible, place the steps in chronological order.
- Be concise. Readers appreciate clear and concise instructions.
- Avoid the use of introductory phrases, such as "In the next step", "The next thing to do is", "Then", "Next," or "Now that you have done step 1, here is Step 2."
- Make sure the steps do not raise new questions that the copy does not answer. There may be an occasional step that requires more explanation. If so, give an explanation. Don't oversimplify to the point that the step is difficult to follow.
- Add a bit of explanation to a step if it helps the user.
- Recognize you will be able to give helpful notes and warnings in other fields.
- Avoid the first person. While writing on WikiOD does not need to be neutral, the best writing should not make any personal references to the authors or authors website.
Category (Optional)[edit | edit source]
After writing the article you put the suitable category for that article. The setting category is optional, If you can't able to find a suitable category don't worry leave it as it is, our team will find the best suitable category for your article.
WikiOD currently focusing on the following categories:
- Category:Tutorials - has a list of all programming related tutorial/subjects related tutorials.
- Category:Articles - has a list of all programming related tutorial/subjects related articles.
- Category:Reference - has a list of all programming language reference.
- Category:Cheat_Sheets - has a list of all programming language cheat sheets.
Suppose if are writing PHP related tutorial, then the category is Category:PHP.
If are writing PHP related articles, then the category is Category:PHP_Articles.
The wikitext syntax for placing category is
]], If you are editing in VisualEditor then please refer the VisualEditor Category Guide
Notes[edit | edit source]
- The "Notes" field is optional. The Notes field gives you a little more latitude to explain a step or to give further advice. For example, for a WikiOD about making a concatenation string, you might add a note that says, "When using coalescing operator on string concatenation don't forget to use parentheses ()."
- Good writing excludes the use of:
- ALL CAPS
- instant messenger language abbreviations - R U OK?
- emoticons - :)
- excessive punctuation - !!!
- sentences starting with lower case - "null coalescing (??) is a new operator introduced in PHP 7."
Warnings[edit | edit source]
- The "Warnings" field is optional. It is used specifically for warnings of possible dangerous or harmful consequences and risks, or it can be used for explaining any undesirable results that might occur when following the steps of the relevant WikiOD article. These can involve anything from advisories about the crash of data or storage if you don't back up your data.
Things You'll Need[edit | edit source]
- This is an optional bullet-pointed list of software.
Related WikiODS[edit | edit source]
- Use this section to Add Related WikiODs on similar topics. For example, a page on how to create a login validation might link to pages on how to prevent SQL injection.
- How to View Your WikiOD Watchlist
Sources or Credit[edit | edit source]
- This optional section can contain links that provide attribution of where the article came from, or other sources and cites mentioned in the article. If you are providing attribution for the article be sure that you have already received permission to use the content.
- http://www.example.com - Source of information on (insert specifics here).
Normally, you can't insert external links in wikiod page. please contact admin for enabling that feature
Edit Summary[edit | edit source]
- Leave a note here to explain your edit details to other authors what you did and why. For example, you might write "spelling", or "added details" or "removed personal references".
Some Final Thoughts[edit | edit source]
Thanks again for helping build the world's largest collection of free, "wiki online documentation" WikiOD. When writing a WikiOD please keep in mind that every page should be clear, concise, and accurate. And while it should go without saying, please be sure that all your contributions to WikiOD are entirely your own, or that you have permission from the copyright holder to post them on WikiOD. If we receive any copyright infringement or DCMA complaint from your articles then we may block you or remove your account from WikiOD.
We are so glad you have chosen to join us in building this useful resource. If you have any questions please don't hesitate to email us.
Now that you know how to write a WikiOD tutorial please feel free to and/or start writing!