Changed directory structure

.gitignore

@@ -3,6 +3,6 @@
 .ropeproject
 *.pyc
 /build/
-/docs/build/
+/docs/_build/
 /dist/
 jedi.egg-info/

README.rst

@@ -29,15 +29,15 @@ Jedi for now, you'll have to use VIM. But there are new plugins emerging:
 
 Here are some pictures:
 
-.. image:: https://github.com/davidhalter/jedi/raw/master/docs/source/screenshot_complete.png
+.. image:: https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_complete.png
 
 Completion for almost anything (Ctrl+Space).
 
-.. image:: https://github.com/davidhalter/jedi/raw/master/docs/source/screenshot_function.png
+.. image:: https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_function.png
 
 Display of function/class bodies, docstrings.
 
-.. image:: https://github.com/davidhalter/jedi/raw/master/docs/source/screenshot_pydoc.png
+.. image:: https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_pydoc.png
 
 Pydoc support (with highlighting, Shift+k).
 

docs/Makefile

@@ -5,14 +5,14 @@
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
 PAPER         =
-BUILDDIR      = build
+BUILDDIR      = _build
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4
 PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 # the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 
 .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
 

docs/conf.py

@@ -16,8 +16,8 @@ import sys, os, datetime
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('../..'))
-sys.path.insert(0, os.path.abspath('../../jedi'))
+sys.path.insert(0, os.path.abspath('..'))
+sys.path.insert(0, os.path.abspath('../jedi'))
 sys.path.append(os.path.abspath('_themes'))
 
 # -- General configuration -----------------------------------------------------
@@ -46,7 +46,7 @@ project = u'Jedi'
 copyright = u'2012 - {today.year}, Jedi contributors'.format(today=datetime.date.today())
 
 _path = os.path.dirname(os.path.abspath(__file__))
-with open(_path + '/../../VERSION') as f:
+with open(os.path.join(_path, '../VERSION'), 'r') as f:
     VERSION = f.read().strip()
 
 # The version info for the project you're documenting, acts as replacement for

docs/index.rst

@@ -1,7 +1,7 @@
 Jedi
 ====
 
-Release v\ |version|. (:doc:`Installation <installation>`)
+Release v\ |release|. (:doc:`Installation <docs/installation>`)
 
 .. automodule:: jedi
     :members:
@@ -9,7 +9,7 @@ Release v\ |version|. (:doc:`Installation <installation>`)
 
 Autocompletion can look like this (e.g. VIM plugin):
 
-.. figure:: screenshot_complete.png
+.. figure:: _screenshots/screenshot_complete.png
 
 
 Docs
@@ -18,8 +18,8 @@ Docs
 .. toctree::
    :maxdepth: 1
 
-   installation
-   plugin-api
+   docs/installation
+   docs/plugin-api
 
 
 Resources