Browse Source

Small reorganisation of doc's structure.

Rafał Pitoń 11 years ago
parent
commit
d716869332
4 changed files with 19 additions and 26 deletions
  1. 1 1
      docs/conf.py
  2. 0 5
      docs/extending/coding_style.rst
  3. 0 14
      docs/extending/index.rst
  4. 18 6
      docs/index.rst

+ 1 - 1
docs/conf.py

@@ -43,7 +43,7 @@ source_suffix = '.rst'
 master_doc = 'index'
 master_doc = 'index'
 
 
 # General information about the project.
 # General information about the project.
-project = u'Misago'
+project = u'Misago Documentation'
 copyright = u'2014, Rafał Pitoń'
 copyright = u'2014, Rafał Pitoń'
 
 
 # The version info for the project you're documenting, acts as replacement for
 # The version info for the project you're documenting, acts as replacement for

+ 0 - 5
docs/extending/coding_style.rst

@@ -1,5 +0,0 @@
-===============================
-Coding Style and Best Practices
-===============================
-
-Lorem ipsum dolor met

+ 0 - 14
docs/extending/index.rst

@@ -1,14 +0,0 @@
-==================
-Writing Extensions
-==================
-
-Lorem ipsum dolor met
-
-
-Index of Contents
------------------
-
-.. toctree::
-   :maxdepth: 2
-
-   coding_style

+ 18 - 6
docs/index.rst

@@ -1,5 +1,5 @@
 ====================
 ====================
-Misago Documentation
+Overview
 ====================
 ====================
 
 
 Welcome to Misago documentation!
 Welcome to Misago documentation!
@@ -34,10 +34,22 @@ This part of documentation is aimed at users who interact with Misago by the gra
 Developers
 Developers
 ==========
 ==========
 
 
-1. Changing Appearance
-2. Writing Extensions
+Misago is being developed with customizability and extensibility on mind and offers many features for those looking into modifying its look and feel, extending its featurebase or changing behaviour of core features.
+
+And if this isn't enough for you, Misago itself stands on shoulders of `Django <https://www.djangoproject.com/>`_, powerful and battle-tested web framework with great documentation and rich ecosystem of additional modules (named "apps"). This means Misago is not "just forum solution". Its also complete framework you may use to build your entire site around, writing your own Django apps or installing and adapting one of thousands ready apps freely available in the internet.
+
+
+Customizing Appearance
+----------------------
+
+
+
+
+Writing Extensions
+------------------
+
+
+Understanding Internals
+-----------------------
 
 
-.. toctree::
-   :maxdepth: 1
 
 
-   extending/index