Documentation/sd: Difference between revisions
Content deleted Content added
Updating to match new version of source page |
Updating to match new version of source page |
||
| Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{tocright}} |
{{tocright}} |
||
{{MediaWiki Introduction}} |
|||
== Overview == |
== Overview == |
||
Revision as of 22:08, 4 September 2020
Overview
Technical documentation refers to any documentation that contains information regarding a technical product, process, or task.
Documentation for Wikimedia projects is widely spread across different wikis and websites. This page focuses on technical documentation for MediaWiki and related software.
Documentation pages
- MediaWiki documentation style guide
- Templates for formatting text
- Resources for technical documentarians
- Guidelines for technical documentation tasks
- Different technical writing genres
- A guide for new technical writers
Documentation structure
- On MediaWiki.org:
- A Technical Manual for information about the MediaWiki Software.
- Project based documentation. This includes user guides, API documentation, tutorials, development information and reference materials related to specific projects.
- Help pages contain end-user specific documentation and Special pages provide some on-demand documentation.
- Auto-generated API documentation:
- Documentation generated from the source code of MediaWiki: doc.wikimedia.org.
- Text files in the /docs directory of MediaWiki source tree have code related information.
Supporting resources include blogs, talk pages and discussion forums.
Some documentation is yet to be migrated from meta.wikimedia.org. See MetaProject to transfer content to MediaWiki.org
Documentation audiences
Primary users of the MediaWiki documentation and the most useful set of pages for each user-group are listed below.
- Wiki users (end users of the MediaWiki software)
Help:فهرست at mediawiki.org and meta are concise forms of end-user documentation. - System administrators
Pages linked to Category:MediaWiki for site admins and Sysadmin hub contain sysadmin specific information. Manual:Contents serves as the reference guide. - Wiki administrators
MediaWiki Administrator's Handbook and Manual:Administrators contain resources for administrators. مينيوئل:مواد فهرست serves as the reference guide. - Developers
- Code developers and administrators
New Developers, مينيوئل:مواد فهرست and linked pages are a starting point for beginners. Experienced developers refer to ڊولپر حب. - Add-ons developers
References include ڊولپر حب, مينيوئل:ايڪسٽينشنز, زمرو:وڌاءَ, Gadget kitchen, Manual:Bots, etc., besides the software installation guidelines. - Designers
Pages linked to Design. - Translators and technical writers
Translator hub and Help:فهرست for getting started followed by the project specific mediawiki pages.
- Code developers and administrators