Add models and recipes structure
Models and recipes
==================
-This section will contain information about different models that OpenSeq2Seq
-supports, exact config parameters to train them, final training/validation/test
-metrics and links to checkpoints of trained models.
\ No newline at end of file
+.. This section will contain information about different models that OpenSeq2Seq
+.. supports, exact config parameters to train them, final training/validation/test
+.. metrics and links to checkpoints (tensorboards also?) of trained models.
+
+Currently OpenSeq2Seq has implemented models for machine translation and
+automatic speech recognition. Namely, the following models are supported
+(to run evaluation or inference the same config can be used with corresponding
+mode):
+
+Machine translation
+-------------------
+
+GNMT
+~~~~
+
+Model description: https://arxiv.org/abs/1609.08144.
+
+Command to train on 4 GPUs::
+
+ python run.py --config_file=example_configs/text2text/xxx-4GPUs.py --mode=train_eval
+
+Final metrics: test BLEU score = xx.xx. Model checkpoint: link.
+
+Command to train on 1 GPU::
+
+ python run.py --config_file=example_configs/text2text/xxx-1GPU.py --mode=train_eval
+
+Final metrics: test BLEU score = xx.xx. Model checkpoint: link.
+
+Transformers
+~~~~~~~~~~~~
+
+Model description: https://arxiv.org/abs/1706.03762.
+
+Command to train on 4 GPUs::
+
+ python run.py --config_file=example_configs/text2text/xxx-4GPUs.py --mode=train_eval
+
+Final metrics: test BLEU score = xx.xx. Model checkpoint: link.
+
+Command to train on 1 GPU::
+
+ python run.py --config_file=example_configs/text2text/xxx-1GPU.py --mode=train_eval
+
+Final metrics: test BLEU score = xx.xx. Model checkpoint: link.
+
+Speech recognition
+------------------
+
+Deep Speech 2
+~~~~~~~~~~~~~
+
+Model description: https://arxiv.org/abs/1512.02595.
+
+Command to train on 4 GPUs::
+
+ python run.py --config_file=example_configs/speech2text/xxx-4GPUs.py --mode=train_eval
+
+Final metrics: test WER = xx.xx. Model checkpoint: link.
+
+Command to train on 1 GPU::
+
+ python run.py --config_file=example_configs/speech2text/xxx-1GPU.py --mode=train_eval
+
+Final metrics: test WER = xx.xx. Model checkpoint: link.
