added direct links to docs

pytorch_lightning/core/lightning.py

@@ -1,8 +1,14 @@
 """
-LightningModule
-====================================
+The LightningModule is the "system recipe." It groups the following in one file:
+    - computational system definition
+    - computations done on forward
+    - training loop
+    - validation loop
+    - testing loop
+    - train, val, test dataloaders
+    - optimizers
+"""
 
-"""
 import os
 import warnings
 import collections

pytorch_lightning/trainer/__init__.py

@@ -1,7 +1,4 @@
 """
-Trainer
-====================================
-
 The lightning Trainer abstracts best practices for running a training, val, test routine.
  It calls parts of your model when it wants to hand over full control and otherwise makes
  training assumptions which are now standard practice in AI research.