update

README.md

@@ -67,17 +67,11 @@ After all, `class` syntax in JavaScript is only a sugar on top of the constructo
 
 Lifecycle can be minimized with smart change detection and cache mechanism. Also, those callbacks can be applied independently in the property scope rather than globally in the component definition.
 
-With all of that, the code becomes simple to understand and data flow is written in a declarative way. Are you sold? You can read more in the [Core Concepts](docs/core-concepts/README.md) section of the project documentation.
+With all of that, the code becomes simple to understand and data flow is written in a declarative way. Are you sold? You can read more in the [Introduction](docs/core-concepts/introduction.md) section of the project documentation.
 
 ## Documentation
 
-The hybrids documentation is available at [gitbook.io](https://hybrids.gitbook.io/hybrids) or in the [docs](docs/README.md) of this repository:
-
-- [Core Concepts](docs/core-concepts/README.md)
-- [Built-in Factories](docs/built-in-factories/README.md)
-- [Templates](docs/templates.md)
-- [Utils](docs/utils.md)
-- [API Reference](docs/api-reference.md)
+The hybrids documentation is available at [gitbook.io](https://hybrids.gitbook.io/hybrids) or in the [docs](docs/README.md) path of this repository.
 
 ### Talks & Articles
 

docs/README.md

@@ -1,29 +1,36 @@
 # Table of Contents
 
-* [Overview](../README.md)
-* [Core Concepts](core-concepts/README.md)
-  * [Property Descriptors](core-concepts/property-descriptors.md)
-  * [Factories](core-concepts/factories.md)
-  * [Property Translation](core-concepts/property-translation.md)
-  * [Simplified Lifecycle](core-concepts/simplified-lifecycle.md)
-  * [Component Definition](core-concepts/component-definition.md)
-* [Built-in Factories](built-in-factories/README.md)
-  * [Property](built-in-factories/property.md)
-  * [Parent & Children](built-in-factories/parent-children.md)
-  * [Render](built-in-factories/render.md)
-* [Templates](templates.md)
-  * [Properties & Attributes](templates.md#properties-and-attributes)
-  * [Event Listeners](templates.md#event-listeners)
-  * [Values](templates.md#values)
-  * [Conditions](templates.md#conditions)
-  * [Nested Templates](templates.md#nested-templates)
-  * [Arrays](templates.md#arrays)
-  * [Promises](templates.md#promises)
-  * [Resolving Dependencies](templates.md#resolving-dependencies)
-  * [Limitations](templates.md#limitations)
-* [Utils](utils.md)
+- [Overview](../README.md)
 
-----
+## Core Concepts
 
-* [API Reference](api-reference.md)
-* [Changelog](../CHANGELOG.md)
+- [Introduction](core-concepts/introduction.md)
+- [Property Descriptors](core-concepts/property-descriptors.md)
+- [Factories](core-concepts/factories.md)
+- [Property Translation](core-concepts/property-translation.md)
+- [Simplified Lifecycle](core-concepts/simplified-lifecycle.md)
+- [Component Definition](core-concepts/component-definition.md)
+
+## Built-in Factories
+- [Property](built-in-factories/property.md)
+- [Parent & Children](built-in-factories/parent-children.md)
+- [Render](built-in-factories/render.md)
+
+## Template Engine
+
+- [Templates](templates.md)
+  - [Properties & Attributes](templates.md#properties-and-attributes)
+  - [Event Listeners](templates.md#event-listeners)
+  - [Values](templates.md#values)
+  - [Conditions](templates.md#conditions)
+  - [Nested Templates](templates.md#nested-templates)
+  - [Arrays](templates.md#arrays)
+  - [Promises](templates.md#promises)
+  - [Resolving Dependencies](templates.md#resolving-dependencies)
+  - [Limitations](templates.md#limitations)
+
+## Misc
+
+- [Utils](utils.md)
+- [API Reference](api-reference.md)
+- [Changelog](../CHANGELOG.md)

docs/core-concepts/README.md

@@ -1,5 +1,6 @@
 # Core Concepts
 
+- [Introduction](introduction.md)
 - [Property Descriptors](property-descriptors.md)
 - [Factories](factories.md)
 - [Property Translation](property-translation.md)

docs/core-concepts/introduction.md

@@ -0,0 +1 @@
+# Introduction