From d17d769966282b73ac9b599e7283aa319a271c4f Mon Sep 17 00:00:00 2001
From: Alex Vear <av@axvr.io>
Date: Sun, 24 Feb 2019 15:04:37 +0000
Subject: [PATCH] Add the initial version of the Vim help doc

---
 README.md   | 16 ++++++----------
 doc/org.txt | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+), 10 deletions(-)
 create mode 100644 doc/org.txt

diff --git a/README.md b/README.md
index e136bd6..bedf3bb 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,9 @@
 # Org-mode syntax highlighting for Vim
 
-This is a minimal [Org-mode](https://orgmode.org/) plugin for Vim. It provides
-only the absolute necessities (e.g. syntax highlighting, indentation, folding,
-etc.). The goal of this plugin is to replicate Vim's existing
-[Markdown](https://github.com/tpope/vim-markdown/) editing experience for
+Org.vim is a minimal [Org-mode](https://orgmode.org/) plugin for
+[Vim](https://www.vim.org/). It provides only the absolute necessities (e.g.
+syntax highlighting and folding) at a high standard.
+
+The main goal of this plugin is to replicate [Vim's default
+Markdown](https://github.com/tpope/vim-markdown/) editing experience for
 Org-mode files.
-
-**NOTE**: This plugin is still a work in progress.
-
-- **TODO**: test with other colorthemes
-- **TODO**: fix italics
-- **TODO**: fix spell checker
diff --git a/doc/org.txt b/doc/org.txt
new file mode 100644
index 0000000..cec0812
--- /dev/null
+++ b/doc/org.txt
@@ -0,0 +1,51 @@
+*org.txt*       A minimal Org-mode package providing only the necessities.
+
+
+                      Org.vim Manual by Alex Vear~
+
+
+Welcome to the org.vim user manual.                     *org*  *org.vim*  *vim-org*
+
+    1. Introduction ............................... |org-intro|
+    2. Installation ............................... |org-install|
+    3. Basic syntax ............................... |org-syntax|
+    4. Configuration .............................. |org-configuration|
+
+==============================================================================
+ 1. INTRODUCTION                                                   *org-intro*
+
+Org.vim is a minimal Org-mode package for Vim. It provides only the absolute
+necessities (e.g. syntax highlighting and folding) at a high standard.
+
+The main goal of this package is to replicate Vim's default Markdown editing
+experience for Org-mode files.
+
+==============================================================================
+ 2. INSTALLATION                                                  *org-install*
+
+WIP.
+
+==============================================================================
+ 3. BASIC SYNTAX                                                   *org-syntax*
+
+WIP.
+
+==============================================================================
+ 4. CONFIGURATION                                           *org-configuration*
+
+                                                          *'g:org_use_italics'*
+Value: numeric~
+Default: 0~
+
+Display italic org-mode markup (e.g. `/this is italic org-mode markup/`) using
+the italic variant of your font.
+
+Note: this option is disabled by default because some terminals and monospaced
+fonts don't support the use of italics.
+
+To enable this feature place the following line in your vimrc:
+>
+    let g:org_use_italics = 1
+<
+
+vim:et:ts=8:sts=4:sw=4:tw=78:ft=help:norl: