[doc] update documentation

Author: chaoming0625

brainpy/__init__.py

@@ -54,12 +54,12 @@
 from brainpy import (channels,  # channel models
                      layers,  # ANN layers
                      neurons,  # neuron groups
+                     synapses,  # synapses
                      rates,  # rate models
                      experimental,
                      )
-from brainpy.synapses import (synapses,  # synaptic dynamics
-                              synouts,  # synaptic output
-                              synplast,)  # synaptic plasticity
+from brainpy.synapses import (synouts,  # synaptic output
+                              synplast, )  # synaptic plasticity
 
 from brainpy._src.dynsys import (DynamicalSystem as DynamicalSystem,
                                  Container as Container,

brainpy/synapses/__init__.py

@@ -0,0 +1,5 @@
+
+from .dynamics import *
+from .synouts import *
+from .synplast import *
+

brainpy/synapses/synapses.py renamed to brainpy/synapses/dynamics.py

@@ -459,31 +459,17 @@ def generate_running_docs():
 
 def generate_synapses_docs():
   _write_subsections_v2(
-    'brainpy._src.dyn.synapses',
+    'brainpy.synapses',
     'brainpy.synapses',
     'apis/auto/synapses.rst',
     subsections={
-      'abstract_models': 'Abstract Models',
-      'biological_models': 'Biological Models',
-      'delay_couplings': 'Coupling Models',
-      'gap_junction': 'Gap Junction Models',
-      'learning_rules': 'Learning Rule Models',
+      'dynamics': 'Synaptic Dynamics',
+      'synouts': 'Synaptic Output',
+      'synplast': 'Synaptic Plasticity',
     }
   )
 
 
-def generate_synouts_docs():
-  _write_module(module_name='brainpy.synouts',
-                filename='apis/auto/synouts.rst',
-                header='``brainpy.synouts`` module')
-
-
-def generate_synplast_docs():
-  _write_module(module_name='brainpy.synplast',
-                filename='apis/auto/synplast.rst',
-                header='``brainpy.synplast`` module')
-
-
 def generate_brainpy_docs():
   _write_subsections(
     module_name='brainpy',

docs/auto_generater.py

@@ -35,8 +35,6 @@
 auto_generater.generate_rates_docs()
 auto_generater.generate_running_docs()
 auto_generater.generate_synapses_docs()
-auto_generater.generate_synouts_docs()
-auto_generater.generate_synplast_docs()
 auto_generater.generate_brainpy_docs()
 auto_generater.generate_integrators_doc()
 auto_generater.generate_math_docs()

docs/conf.py

@@ -96,12 +96,10 @@ general-purpose Brain Dynamics Programming (BDP). Among its key ingredients, Bra
    apis/auto/brainpy.rst
    apis/auto/math.rst
    apis/auto/channels.rst
-   apis/auto/layers.rst
    apis/auto/neurons.rst
    apis/auto/rates.rst
    apis/auto/synapses.rst
-   apis/auto/synouts.rst
-   apis/auto/synplast.rst
+   apis/auto/layers.rst
    apis/auto/integrators.rst
    apis/auto/analysis.rst
    apis/auto/connect.rst