diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..ce34cf0a
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,7 @@
+# `wikiteam3` Documentation
+Welcome to the (WIP) documentation of `wikiteam3`!
+
+References:
+ -  [WikiTeam wiki](https://github.com/WikiTeam/wikiteam/wiki)
+ -  [WikiTeam](https://wiki.archiveteam.org/index.php/WikiTeam) at the ArchiveTeam Wiki
+ -  [WikiTeam3 tutorial](https://meta.miraheze.org/wiki/Backups#WikiTeam3) at Miraheze Meta
diff --git a/docs/dump_structure.md b/docs/dump_structure.md
new file mode 100644
index 00000000..b3201233
--- /dev/null
+++ b/docs/dump_structure.md
@@ -0,0 +1,65 @@
+# Dump Structure
+
+Local directory structure:
+
+```
+<url>-<date>-wikidump
+├── config.json
+├── index.html
+├── SpecialVersion.html
+├── siteinfo.json
+├── all_dumped.mark
+├── uploaded_to_IA.mark
+├── errors.log
+├── <url>-<date>-titles.txt
+├── <url>-<date>-history.xml
+├── <url>-<date>-images.txt
+├── images
+│   └── ...
+├── images_mismatch
+│   └── ...
+└── <url>-<date>-redirects.jsonl
+```
+
+Internet Archive item structure:
+
+```
+wiki-<url>-<date>
+├── <url>-<date>-dumpMeta
+│   ├── config.json
+│   ├── index.html
+│   ├── SpecialVersion.html
+│   ├── siteinfo.json
+│   ├── errors.log
+│   ├── <url>-<date>-titles.txt.zst
+│   ├── <url>-<date>-images.txt.zst
+│   └── <url>-<date>-redirects.jsonl.zst
+├── <url>-<date>-history.xml.zst
+├── <url>-<date>-images.7z
+├── <url>-<date>-images_mismatch.7z
+└── <identifier>_logo.<suffix>
+```
+
+## General
+ -  `config.json`: Dump configuration. Used when [resuming an incomplete dump](https://github.com/saveweb/wikiteam3/blob/v4-main/README.md#resuming-an-incomplete-dump).
+ -  `index.html`: Archive of `index.php` (the main page).
+ -  `SpecialVersion.html`: Archive of `[[Special:Version]]`.
+ -  `siteinfo.json`: Archive of Siteinfo API response.
+ -  `all_dumped.mark`: Marks the end of the dump. Content: `<time>:<msg>`
+ -  `uploaded_to_IA.mark`: Marks the success upload to IA. Content: `<time>: identifier: <identifier>`
+ -  `errors.log`: Errors log. Please check this file after the dump is finished.
+ -  `<identifier>_logo.<suffix>`: Logo. This is downloaded when uploading to IA, and would not be stored locally.
+
+## XML Dump
+ -  `<url>-<date>-titles.txt`: List of titles.
+ -  `<url>-<date>-history.xml`: The XML dump. See [Manual:Importing XML dumps](https://www.mediawiki.org/wiki/Manual:Importing_XML_dumps) for importing.
+
+## Image Dump
+ -  `<url>-<date>-images.txt`: Image metadata in TSV (Tab-Separated Values) format.
+ -  `images` (directory): The image dump, i.e. the dump of all uploaded files.
+ -  `<url>-<date>-images.7z`: Compression of the `images` directory.
+ -  `images_mismatch` (directory): Images whose actual size or SHA1 doesn't match API responses. Please contact the webmaster.
+ -  `<url>-<date>-images_mismatch.7z`: Compression of the `images_mismatch` directory.
+
+## Redirects Dump
+ -  `<url>-<date>-redirects.jsonl`: The redirects dump. Each line contains one redirection.
diff --git a/docs/dump_types.md b/docs/dump_types.md
new file mode 100644
index 00000000..4cc710f3
--- /dev/null
+++ b/docs/dump_types.md
@@ -0,0 +1,66 @@
+# Dump Types
+There are three types of backups that can be made with `wikiteam3dumpgenerator`: **XML dumps**, **image dumps**, and **redirect dumps**.
+
+## XML dump
+An XML dump contains the entire history or the latest revision of all pages. To generate an XML dump, use the `--xml` option.
+
+### Revisions
+You can export all revisions (default) or the current revision only.
+
+| Revisions | Option |
+|-----------|--------|
+| All | *None* |
+| Current | `--curonly` |
+
+### API
+List of export APIs supported by wikiteam3:
+ -  [Special:Export](https://www.mediawiki.org/wiki/Manual:Parameters_to_Special:Export) (default)
+     -  First, get the list of page titles to export.
+     -  Then, send POST requests to Special:Export to retrieve all/current revisions of pages in the list. The responses are in XML format.
+ -  [API:Allrevisions](https://www.mediawiki.org/wiki/API:Allrevisions)
+     -  Send GET requests to `api.php` with `action=query&list=allrevisions` to retrieve all/current revisions of all pages. The responses are then converted from JSON to XML.
+     -  This API is significantly faster because it doesn't rely on the list of titles. You may disable delay between requests (`--delay 0`) if you are using this API.
+ -  [API:Revisions](https://www.mediawiki.org/wiki/API:Revisions)
+     -  First, get the list of page titles to export.
+     -  Then, send GET requests to `api.php` with `action=query&format=xml&prop=revisions&titles=<title>` to retrieve all/current revisions of pages in the list. The responses are then converted from JSON to XML.
+ -  [API:Query](https://www.mediawiki.org/wiki/API:Query) (DEVELOPMENT ONLY)
+     -  First, get the list of page titles to export.
+     -  Then, send GET requests to `api.php` with `action=query&titles=<title>&export=1` to retrieve the **current** revision of pages in the list. The exported data is in XML format.
+
+If the list of page titles is needed, wikiteam3 tries [API:Allpages](https://www.mediawiki.org/wiki/API:Allpages) (1.8+) first. If it fails, wikiteam3 then tries to extract page titles from Special:Allpages.
+
+**Limitations**: XML dumps produced using API:Allrevisions or API:Revisions are missing `<redirect>` tags, because these API don't return redirect information. Wikiteam3 introduced redirect dumps to retrieve redirect information. Unfortunately, currently there is no way to patch XML dumps using redirect information from redirect dumps, so the XML dumps will remain slightly flawed.
+
+Here is a table for comparison. Legend:
+ -  **MW version**: Supported MediaWiki versions. The use of old APIs enables wikiteam3 to create dumps for wikis running older versions of MediaWiki software.
+ -  **Titles**: Requires a list of page titles to export before exporting.
+
+| API | Option | MW version | Titles |
+|-----|--------|------------|--------|
+| Special:Export | *None* | 1.16+ (?) | Yes |
+| API:Allrevisions | `--xmlrevisions` | 1.27+ | No |
+| API:Revisions | `--xmlapiexport` | 1.8+ | Yes |
+| API:Query | `--xmlrevisions_page` | 1.8+ | Yes |
+
+TODO: Figure out the exact version for Special:Export
+
+## Image dump
+An image dump contains all files along with their metadata. It is called an *image* dump for historic reasons. To generate an image dump, use the `--images` option.
+
+It takes three steps for the program to create an image dump:
+1.  Get file names and metadata.
+     -  If the API is available, try [API:Allimages](https://www.mediawiki.org/wiki/API:Allimages) (MW 1.13+) first. If it fails, use [API:Allpages](https://www.mediawiki.org/wiki/API:Allpages) (MW 1.8+).
+     -  Otherwise, scrape and parse Special:Imagelist.
+2.  Save file names and metadata at `<url>-<date>-images.txt`. The file format is documented at [`DEV.md`](https://github.com/saveweb/wikiteam3/blob/v4-main/DEV.md).
+3.  Download the files. For each file, the actual size and SHA1 are checked against the API responses:
+     -  If they match, the file would be saved at the `images` directory.
+     -  Otherwise, the file would be saved at the `images_mismatch` directory, and an error message would be written to `errors.log`.
+
+After creating an image dump, please check the `images_mismatch` directory. If files appear in this directory, that would be a problem. The probable cause is that the webmaster has turned on image compression for server responses. Please contact the webmaster.
+
+TODO: File name limitations
+
+## Redirect dump
+A redirect dump contains a list of all redirects. The output file `<url>-<date>-redirects.jsonl` is in JSONL format, each line contains the infomation of one redirect, taken from the response of [API:Allredirects](https://www.mediawiki.org/wiki/API:Allredirects).
+
+This feature is introduced in commit [`f901972`](https://github.com/saveweb/wikiteam3/commit/f901972ffc7525001f23cc20368d6437369c8953), due to limitations of some APIs. See section [XML dump](#xml-dump).
diff --git a/docs/export-0.11-wikiteam3.xsd b/docs/export-0.11-wikiteam3.xsd
new file mode 100644
index 00000000..b4fdbab4
--- /dev/null
+++ b/docs/export-0.11-wikiteam3.xsd
@@ -0,0 +1,350 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+	This is a customized version for wikiteam3. Changes:
+	1. Remove "PageIDConstraint".
+	2. Add optional attribute "arvcontinue" for "PageType".
+	3. Mark "origin" element in "RevisionType" as optional. (This is a bug in wikiteam3! )
+	4. Mark "format" element in "RevisionType" as optional. (This is a bug in wikiteam3! )
+-->
+<!--
+	This is an XML Schema description of the format
+	output by MediaWiki's Special:Export system.
+
+	Version 0.2 adds optional basic file upload info support,
+	which is used by our OAI export/import submodule.
+
+	Version 0.3 adds some site configuration information such
+	as a list of defined namespaces.
+
+	Version 0.4 adds per-revision delete flags, log exports,
+	discussion threading data, a per-page redirect flag, and
+	per-namespace capitalization.
+
+	Version 0.5 adds byte count per revision.
+
+	Version 0.6 adds a separate namespace tag, and resolves the
+	redirect target and adds a separate sha1 tag for each revision.
+
+	Version 0.7 adds a unique identity constraint for both page and
+	revision identifiers. See also bug 4220.
+	Fix type for <ns> from "positiveInteger" to "nonNegativeInteger" to allow 0
+	Moves <logitem> to its right location.
+	Add parentid to revision.
+	Fix type for <id> within <contributor> to "nonNegativeInteger"
+
+	Version 0.8 adds support for a <model> and a <format> tag for
+	each revision. See contenthandler.md.
+
+	Version 0.9 adds the database name to the site information.
+
+	Version 0.10 moved the <model> and <format> tags before the <text> tag.
+
+	Version 0.11 introduced <content> tag.
+
+	The canonical URL to the schema document is:
+	https://www.mediawiki.org/xml/export-0.11.xsd
+
+	Use the namespace:
+	https://www.mediawiki.org/xml/export-0.11/
+-->
+<schema xmlns="http://www.w3.org/2001/XMLSchema"
+		xmlns:mw="http://www.mediawiki.org/xml/export-0.11/"
+		targetNamespace="http://www.mediawiki.org/xml/export-0.11/"
+		elementFormDefault="qualified">
+
+	<annotation>
+		<documentation xml:lang="en">
+			MediaWiki's page export format
+		</documentation>
+	</annotation>
+
+	<!-- Need this to reference xml:lang -->
+	<!--
+		NOTE: If you are using xmllint:
+		1. Download "http://www.w3.org/2001/xml.xsd" and place it under the same directory with this file.
+		2. Replace "http://www.w3.org/2001/xml.xsd" with "xml.xsd" below.
+	-->
+	<import namespace="http://www.w3.org/XML/1998/namespace"
+			schemaLocation="http://www.w3.org/2001/xml.xsd" />
+
+	<!-- Our root element -->
+	<element name="mediawiki" type="mw:MediaWikiType">
+		<!-- Page ID contraint, see bug 4220 -->
+<!--		<unique name="PageIDConstraint">
+			<selector xpath="mw:page" />
+			<field xpath="mw:id" />
+		</unique>-->
+		<!-- Revision ID contraint, see bug 4220 -->
+		<unique name="RevIDConstraint">
+			<selector xpath="mw:page/mw:revision" />
+			<field xpath="mw:id" />
+		</unique>
+	</element>
+
+	<complexType name="MediaWikiType">
+		<sequence>
+			<element name="siteinfo" type="mw:SiteInfoType"
+					 minOccurs="0" maxOccurs="1" />
+			<element name="page" type="mw:PageType"
+					 minOccurs="0" maxOccurs="unbounded" />
+			<element name="logitem" type="mw:LogItemType"
+					 minOccurs="0" maxOccurs="unbounded" />
+		</sequence>
+		<attribute name="version" type="string" use="required" />
+		<attribute ref="xml:lang" use="required" />
+	</complexType>
+
+	<complexType name="SiteInfoType">
+		<sequence>
+			<element name="sitename" type="string" minOccurs="0" />
+            <element name="dbname" type="string" minOccurs="0" />
+			<element name="base" type="anyURI" minOccurs="0" />
+			<element name="generator" type="string" minOccurs="0" />
+			<element name="case" type="mw:CaseType" minOccurs="0" />
+			<element name="namespaces" type="mw:NamespacesType" minOccurs="0" />
+		</sequence>
+	</complexType>
+
+	<simpleType name="CaseType">
+		<restriction base="NMTOKEN">
+			<!-- Cannot have two titles differing only by case of first letter. -->
+			<!-- Default behavior through 1.5, $wgCapitalLinks = true -->
+			<enumeration value="first-letter" />
+
+			<!-- Complete title is case-sensitive -->
+			<!-- Behavior when $wgCapitalLinks = false -->
+			<enumeration value="case-sensitive" />
+
+			<!-- Cannot have non-case senstitive titles eg [[FOO]] == [[Foo]] -->
+			<!-- Not yet implemented as of MediaWiki 1.18 -->
+			<enumeration value="case-insensitive" />
+		</restriction>
+	</simpleType>
+
+	<simpleType name="DeletedFlagType">
+		<restriction base="NMTOKEN">
+			<enumeration value="deleted" />
+		</restriction>
+	</simpleType>
+
+	<complexType name="NamespacesType">
+		<sequence>
+			<element name="namespace" type="mw:NamespaceType"
+					 minOccurs="0" maxOccurs="unbounded" />
+		</sequence>
+	</complexType>
+
+	<complexType name="NamespaceType">
+		<simpleContent>
+			<extension base="string">
+				<attribute name="key" type="integer" />
+				<attribute name="case" type="mw:CaseType" />
+			</extension>
+		</simpleContent>
+	</complexType>
+
+	<complexType name="RedirectType">
+		<simpleContent>
+			<extension base="string">
+				<attribute name="title" type="string" />
+			</extension>
+		</simpleContent>
+	</complexType>
+
+	<simpleType name="ContentModelType">
+		<restriction base="string">
+			<pattern value="[a-zA-Z][-+./a-zA-Z0-9]*" />
+		</restriction>
+	</simpleType>
+
+	<simpleType name="ContentFormatType">
+		<restriction base="string">
+			<pattern value="[a-zA-Z][-+.a-zA-Z0-9]*/[a-zA-Z][-+.a-zA-Z0-9]*" />
+		</restriction>
+	</simpleType>
+
+	<complexType name="PageType">
+		<sequence>
+			<!-- Title in text form. (Using spaces, not underscores; with namespace ) -->
+			<element name="title" type="string" />
+
+			<!-- Namespace in canonical form -->
+			<element name="ns" type="nonNegativeInteger" />
+
+			<!-- optional page ID number -->
+			<element name="id" type="positiveInteger" />
+
+			<!-- flag if the current revision is a redirect -->
+			<element name="redirect" type="mw:RedirectType" minOccurs="0" maxOccurs="1" />
+
+			<!-- comma-separated list of string tokens, if present -->
+			<element name="restrictions" type="string" minOccurs="0" />
+
+			<!-- Zero or more sets of revision or upload data -->
+			<choice minOccurs="0" maxOccurs="unbounded">
+				<element name="revision" type="mw:RevisionType" />
+				<element name="upload" type="mw:UploadType" />
+			</choice>
+
+			<!-- Zero or One sets of discussion threading data -->
+			<element name="discussionthreadinginfo" minOccurs="0" maxOccurs="1" type="mw:DiscussionThreadingInfo" />
+
+		</sequence>
+		<attribute name="arvcontinue" type="string" />
+	</complexType>
+
+	<complexType name="RevisionType">
+		<sequence>
+			<element name="id" type="positiveInteger" />
+			<element name="parentid" type="positiveInteger" minOccurs="0" maxOccurs="1" />
+			<element name="timestamp" type="dateTime" />
+			<element name="contributor" type="mw:ContributorType" />
+			<element name="minor" minOccurs="0" maxOccurs="1" />
+			<element name="comment" type="mw:CommentType" minOccurs="0" maxOccurs="1" />
+			<!-- corresponds to slot origin for the main slot -->
+			<element name="origin" type="positiveInteger" minOccurs="0" maxOccurs="1" />
+			<!-- the main slot's content model -->
+			<element name="model" type="mw:ContentModelType" />
+			<!-- the main slot's serialization format -->
+			<element name="format" type="mw:ContentFormatType" minOccurs="0" maxOccurs="1" />
+			<!-- the main slot's serialized content -->
+			<element name="text" type="mw:TextType"/>
+			<element name="content" type="mw:ContentType" minOccurs="0" maxOccurs="unbounded"/>
+			<!-- sha1 of the revision, a combined sha1 of content in all slots -->
+			<element name="sha1" type="string" />
+		</sequence>
+	</complexType>
+
+	<complexType name="ContentType">
+		<sequence>
+			<!-- corresponds to slot role_name -->
+			<element name="role" type="mw:SlotRoleType" />
+			<!-- corresponds to slot origin -->
+			<element name="origin" type="positiveInteger" />
+			<element name="model" type="mw:ContentModelType" />
+			<element name="format" type="mw:ContentFormatType" />
+			<element name="text" type="mw:ContentTextType" />
+		</sequence>
+	</complexType>
+
+	<simpleType name="SlotRoleType">
+		<restriction base="string">
+			<pattern value="[a-zA-Z][-+./a-zA-Z0-9]*" />
+		</restriction>
+	</simpleType>
+
+	<complexType name="ContentTextType">
+		<simpleContent>
+			<extension base="string">
+				<attribute ref="xml:space" default="preserve" />
+				<!-- This allows deleted=deleted on non-empty elements, but XSD is not omnipotent -->
+				<attribute name="deleted" type="mw:DeletedFlagType" />
+				<attribute name="location" type="anyURI" />
+				<attribute name="sha1" type="string" />
+				<attribute name="bytes" type="nonNegativeInteger" />
+			</extension>
+		</simpleContent>
+	</complexType>
+
+	<complexType name="LogItemType">
+		<sequence>
+			<element name="id" type="positiveInteger" />
+			<element name="timestamp" type="dateTime" />
+			<element name="contributor" type="mw:ContributorType" />
+			<element name="comment" type="mw:CommentType" minOccurs="0" />
+			<element name="type" type="string" />
+			<element name="action" type="string" />
+			<element name="text" type="mw:LogTextType" minOccurs="0" maxOccurs="1" />
+			<element name="logtitle" type="string" minOccurs="0" maxOccurs="1" />
+			<element name="params" type="mw:LogParamsType" minOccurs="0" maxOccurs="1" />
+		</sequence>
+	</complexType>
+
+	<complexType name="CommentType">
+		<simpleContent>
+			<extension base="string">
+				<!-- This allows deleted=deleted on non-empty elements, but XSD is not omnipotent -->
+				<attribute name="deleted" type="mw:DeletedFlagType" />
+			</extension>
+		</simpleContent>
+	</complexType>
+
+	<complexType name="TextType">
+		<simpleContent>
+			<extension base="string">
+				<attribute ref="xml:space" default="preserve" />
+				<!-- This allows deleted=deleted on non-empty elements, but XSD is not omnipotent -->
+				<attribute name="deleted" type="mw:DeletedFlagType" />
+				<!-- This isn't a good idea; we should be using "ID" instead of "NMTOKEN" -->
+				<!-- However, "NMTOKEN" is strictest definition that is both compatible with existing -->
+				<!-- usage ([0-9]+) and with the "ID" type. -->
+				<attribute name="id" type="NMTOKEN" />
+				<attribute name="location" type="anyURI" />
+				<attribute name="sha1" type="string"/>
+				<attribute name="bytes" type="nonNegativeInteger" />
+			</extension>
+		</simpleContent>
+	</complexType>
+
+	<complexType name="LogTextType">
+		<simpleContent>
+			<extension base="string">
+				<!-- This allows deleted=deleted on non-empty elements, but XSD is not omnipotent -->
+				<attribute name="deleted" type="mw:DeletedFlagType" />
+			</extension>
+		</simpleContent>
+	</complexType>
+
+	<complexType name="LogParamsType">
+		<simpleContent>
+			<extension base="string">
+				<attribute ref="xml:space" default="preserve" />
+			</extension>
+		</simpleContent>
+	</complexType>
+
+	<complexType name="ContributorType">
+		<sequence>
+			<element name="username" type="string" minOccurs="0" />
+			<element name="id" type="nonNegativeInteger" minOccurs="0" />
+
+			<element name="ip" type="string" minOccurs="0" />
+		</sequence>
+		<!-- This allows deleted=deleted on non-empty elements, but XSD is not omnipotent -->
+		<attribute name="deleted" type="mw:DeletedFlagType" />
+	</complexType>
+
+	<complexType name="UploadType">
+		<sequence>
+			<!-- Revision-style data... -->
+			<element name="timestamp" type="dateTime" />
+			<element name="contributor" type="mw:ContributorType" />
+			<element name="comment" type="string" minOccurs="0" />
+
+			<!-- Filename. (Using underscores, not spaces. No 'File:' namespace marker.) -->
+			<element name="filename" type="string" />
+
+			<!-- URI at which this resource can be obtained -->
+			<element name="src" type="anyURI" />
+
+			<element name="size" type="positiveInteger" />
+
+			<!-- TODO: add other metadata fields -->
+		</sequence>
+	</complexType>
+
+	<!-- Discussion threading data for LiquidThreads -->
+	<complexType name="DiscussionThreadingInfo">
+		<sequence>
+			<element name="ThreadSubject" type="string" />
+			<element name="ThreadParent" type="positiveInteger" />
+			<element name="ThreadAncestor" type="positiveInteger" />
+			<element name="ThreadPage" type="string" />
+			<element name="ThreadID" type="positiveInteger" />
+			<element name="ThreadAuthor" type="string" />
+			<element name="ThreadEditStatus" type="string" />
+			<element name="ThreadType" type="string" />
+		</sequence>
+	</complexType>
+
+</schema>
diff --git a/docs/images/tutorial-entry-point.png b/docs/images/tutorial-entry-point.png
new file mode 100644
index 00000000..6d9fd219
Binary files /dev/null and b/docs/images/tutorial-entry-point.png differ
diff --git a/docs/images/tutorial-powered-by-mediawiki.png b/docs/images/tutorial-powered-by-mediawiki.png
new file mode 100644
index 00000000..97628511
Binary files /dev/null and b/docs/images/tutorial-powered-by-mediawiki.png differ
diff --git a/docs/images/tutorial-search-ia.png b/docs/images/tutorial-search-ia.png
new file mode 100644
index 00000000..89a8273f
Binary files /dev/null and b/docs/images/tutorial-search-ia.png differ
diff --git a/docs/tutorial.md b/docs/tutorial.md
new file mode 100644
index 00000000..af5b7255
--- /dev/null
+++ b/docs/tutorial.md
@@ -0,0 +1,177 @@
+# Tutorial
+Welcome! You are probably learning how to archive your favorite wiki using wikiteam3.
+
+Before we get started, please answer these questions:
+
+## Do I really need wikiteam3?
+### Do you have direct shell access to the server?
+If you have direct shell access to the server, the best option is to backup all server files (see [Manual:Backing up a wiki](https://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki)).
+
+Wikiteam3 can only backup public pages and files, it cannot backup deleted pages, logs, user preferences...
+
+### Is this wiki recently archived?
+It is recommended to look for existing dumps before making one. Usually, if there is a dump within a year, it would be unnecessary to make another one. Exceptions include that the wiki is going to shut down.
+
+Nowadays, most MediaWiki dumps reside in the Internet Archive, with a custom metadata field named `originalurl`, with the value of the `api.php` (or `index.php`) entry point URL (see below). It can be searched with the advanced search syntax `(originalurl:"XXX")`. Asterisks (`*`) are useful for fuzzy matching.
+
+For example, to search the existing dumps of the [ArchiveTeam Wiki](https://wiki.archiveteam.org/), use expression `(originalurl:"https://wiki.archiveteam.org/api.php")` or simply `(originalurl:"*wiki.archiveteam.org*")`.
+
+<figure>
+  <img src="images/tutorial-search-ia.png" alt="Searching for existing dumps on the Internet Archive" style="max-height: 25em">
+  <figcaption>Searching for existing dumps on the Internet Archive</figcaption>
+</figure>
+
+### Can wikiteam help you do this favor?
+<!-- This paragraph is taken from README.md -->
+WikiTeam is always willing to help! For public MediaWiki, there is no need to run wikiteam3 by yourself. You can send an archive request to the [**WikiTeam IRC channel**](https://chat.hackint.org/?join=%23wikiteam) ([logs](https://irclogs.archivete.am/wikiteam)). Please include the archive reason in your request (e.g. the wiki is about to shutdown, a wikidump is needed to migrate to another wikifarm, etc.). An online member will run a [wikibot](https://wikibot.digitaldragon.dev/) job for your request.
+
+If the wiki is private, you would have to run wikiteam3 by yourself:
+
+### Is the wiki powered by MediaWiki?
+Is the wiki you want to archive powered by MediaWiki?
+
+Most wikis powered by MediaWiki have a banner at the bottom-right corner. There is also a list of [sites using MediaWiki](https://www.mediawiki.org/wiki/Sites_using_MediaWiki) at MediaWiki.org.
+
+<figure>
+  <img src="images/tutorial-powered-by-mediawiki.png" alt="The latest &quot;Powered by MediaWiki&quot; banner" style="max-height: 5em">
+  <figcaption>The latest "Powered by MediaWiki" banner</figcaption>
+</figure>
+
+If the wiki is not powered by MediaWiki, you would have to use dedicated tools for other wikis. For DokuWiki, try [DokuWiki Dumper](https://github.com/saveweb/dokuwiki-dumper); for PukiWiki, try [PukiWiki Dumper](https://github.com/saveweb/pukiwiki-dumper).
+
+## Installing wikiteam3
+Wikiteam3 is a Python package. There is a detailed tutorial for [**installing packages**](https://packaging.python.org/en/latest/tutorials/installing-packages/) at Python Packaging User Guide. Please follow it to install Python (if you haven't installed) and wikiteam3.
+
+Key points:
+1.  First, install Python 3 if you haven't installed it. Make sure you can run both Python and pip from the command line:
+
+    ```console
+    $ python3 --version
+    $ python3 -m pip --version
+    ```
+
+2.  Then, simply install wikiteam3 from [pip](https://pypi.org/project/wikiteam3/). However, it is recommended to install wikiteam3 in a *virtual environment*, which isolates wikiteam3 and other Python packages.
+
+    ```console
+    $ python3 -m pip install wikiteam3
+    ```
+
+    If you have installed wikiteam3 correctly, a help message would appear if you run the following command:
+
+    ```console
+    $ wikiteam3dumpgenerator --help
+    ```
+
+> [!NOTE]
+> If you are a developer, it is recommended to clone wikiteam3 from [GitHub](https://github.com/saveweb/wikiteam3), and install it in *editable mode*.
+
+## Generating a wiki dump
+`wikiteam3dumpgenerator` can generate wiki dumps.
+
+```console
+$ wikiteam3dumpgenerator [OPTIONS]... [WIKI]
+```
+
+There are a lot of options to fill in, including entry point URLs, dump types, and so on.
+
+Here we will use the [ArchiveTeam Wiki](https://wiki.archiveteam.org/) as an example.
+
+### Entry point URLs
+Wikiteam3 needs the entry point URLs of `api.php` and `index.php` to archive a wiki. 
+
+The easiest way is to pass the base URL of the wiki you want to backup, and wikiteam3 will try to *guess* the entry point URLs:
+
+```console
+$ wikiteam3dumpgenerator [OPTIONS]... https://wiki.archiveteam.org/
+```
+
+However, this can sometimes fail. A safer way is to provide the entry point URLs by yourself.
+
+First, navigate to the "Special:Version" special page. You can simply type "Special:Version" in the search box and hit "Enter".
+
+Then, scroll to section "Entry point URLs", and copy the entry points of `api.php` and `index.php`. In our example, the URL of `api.php` is `https://wiki.archiveteam.org/api.php`, and the URL of `index.php` is `https://wiki.archiveteam.org/index.php`. So pass these options:
+
+```console
+$ wikiteam3dumpgenerator \
+  --api https://wiki.archiveteam.org/api.php \
+  --index https://wiki.archiveteam.org/index.php \
+  [OPTIONS]...
+```
+
+<img src="images/tutorial-entry-point.png" alt="Path to api.php and index.php can be found from the &quot;Entry point URLs&quot; section in &quot;Special:Version&quot;" style="max-height: 15em">
+
+### Dump types
+*Main article: [Dump Types](dump_types.md)*
+
+Wikiteam3 currently supports three types of dumps: XML dumps, image dumps, and redirect dumps.
+
+For more information, read the "Dump Types" page.
+
+It is recommended to include all of them: `--xml --xmlrevisions --images --redirects`.
+
+### Start dumping
+Open the terminal, and `cd` to where you would save your dump. If you installed wikiteam3 in a virtual environment, activate it. Then run wikiteam3 with the arguments you selected.
+
+In our example, here are the arguments:
+```console
+$ wikiteam3dumpgenerator \
+  --api 'https://wiki.archiveteam.org/api.php' \
+  --index 'https://wiki.archiveteam.org/index.php' \
+  --xml --xmlrevisions \
+  --images \
+  --redirects
+```
+
+Wikiteam3 will create a directory named `<url>-<date>-wikidump`.
+
+### Checking your dump
+Most errors are recorded in `errors.log`.
+
+#### Checking XML dump integrity
+How to make sure that the XML dump you just made is valid? The ultimate way is to import it into a running MediaWiki instance, which may be slow and complicated. Here are a few ways to quickly check its integrity:
+
+---
+
+If you want to check the XML dump integrity, type this into your command line to count title, page and revision XML tags:
+
+An easy approach is to count the numbers of `<title>`, `<page>`, and `<revision>` tags with `grep`, which is available on almost all Linux distributions.
+
+Run the following command, the results should look like this:
+
+```console
+$ grep -E '<title(.*?)>' *.xml -c; grep -E '<page(.*?)>' *.xml -c; grep "</page>" *.xml -c;grep -E '<revision(.*?)>' *.xml -c;grep "</revision>" *.xml -c
+580
+580
+580
+5677
+5677
+```
+
+The first three numbers should be the same and the last two should be the same as each other (the actual numbers may differ). If not, then, your XML dump is corrupted (it is missing one or more `</page>` or `</revision>` end tags).
+
+---
+
+The above method roughly ensures that the XML dump is not damaged. To make sure that the dump applies to the official schema, use `xmllint`:
+
+```console
+$ xmllint --schema export-0.11-wikiteam3.xsd path/to/<url>-<date>-history.xml --noout
+<url>-<date>-history.xml validates
+```
+
+Here we are using `export-0.11-wikiteam3.xsd`, a slightly modified version of the official `export-0.11.xsd` schema. Since `xmllint` cannot access remote schemas, please follow the instructions in the schema to replace the remote schema with a local one.
+
+If it says that `<url>-<date>-history.xml validates`, the XML applies to the schema. If it says that `<url>-<date>-history.xml fails to validate`, the XML is problematic. Please report to us.
+`.
+
+---
+
+XML dumps for large wikis have a higher chance to get damaged. If your dump is unfortunately damaged, the solution is to re-run the dump process, until you succeed.
+
+#### Mismatching images
+If images appear in the `images_mismatch` directory, this is likely because that the webmaster has enabled server-side compression for images, please contact the webmaster.
+
+#### Other errors
+Just read `errors.log` and fix them.
+
+### Upload your dump to the Internet Archive (optional)
+See [README](https://github.com/saveweb/wikiteam3/blob/v4-main/README.md#using-wikiteam3uploader).