Feature/add docs (#689)

* Add converted docs repo

* Set theme jekyll-theme-minimal

* Removed BC docs, added TOC

* Added TOCs, rewrote most important links in documentation. Linked README to new Github Pages site

* some link fixes

1 files changed, 37 insertions, 0 deletions

diff --git a/docs/designers/language-builtin-functions/language-function-extends.md b/docs/designers/language-builtin-functions/language-function-extends.md
new file mode 100644
index 00000000..9559e7c5
--- /dev/null
+++ b/docs/designers/language-builtin-functions/language-function-extends.md
@@ -0,0 +1,37 @@
+{extends} {#language.function.extends}
+=========
+
+`{extends}` tags are used in child templates in template inheritance for
+extending parent templates. For details see section of [Template
+Interitance](#advanced.features.template.inheritance).
+
+-   The `{extends}` tag must be on the first line of the template.
+
+-   If a child template extends a parent template with the `{extends}`
+    tag it may contain only `{block}` tags. Any other template content
+    is ignored.
+
+-   Use the syntax for [template resources](#resources) to extend files
+    outside of the [`$template_dir`](#variable.template.dir) directory.
+
+> **Note**
+>
+> When extending a variable parent like `{extends file=$parent_file}`,
+> make sure you include `$parent_file` in the
+> [`$compile_id`](#variable.compile.id). Otherwise Smarty cannot
+> distinguish between different `$parent_file`s.
+
+**Attributes:**
+
+   Attribute Name    Type    Required   Default  Description
+  ---------------- -------- ---------- --------- -------------------------------------------------
+        file        string     Yes       *n/a*   The name of the template file which is extended
+
+
+    {extends file='parent.tpl'}
+    {extends 'parent.tpl'}  {* short-hand *}
+
+      
+
+See also [Template Interitance](#advanced.features.template.inheritance)
+and [`{block}`](#language.function.block).