# Advanced Tutorials/Documentation

**URL:** <https://discourse.aurelia.io/t/advanced-tutorials-documentation/447>\
**Category:** Site Feedback\
**Created:** [November 28, 2017, 8:44pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447 "2017-11-28T20:44:22Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![tbnovaes](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/tbnovaes/32/147_2.png) [@tbnovaes](https://discourse.aurelia.io/u/tbnovaes)\
**Post date:** [November 28, 2017, 8:44pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/1 "2017-11-28T20:44:22Z")

</div>

It would be great to have advanced content and examples for the API. For instance, how do do better use of the template engine, to create things like aurelia-dialog.

Currently going to the API Documentation, show us the methods available, but nothing helpful about how to implement them.

---

<div class="post-metadata">

**Author:** ![rkever](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/rkever/32/145_2.png) [@rkever](https://discourse.aurelia.io/u/rkever)\
**Post date:** [November 29, 2017, 3:30pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/2 "2017-11-29T15:30:51Z")

</div>

Agreed. I know the guys are pretty busy and not sure how detailed they can get but Highcharts has a GREAT example of how an API documentation can be built well. IMHO they have the best API documentation out there. In almost every method doc there is a jsfiddle example implementation as well as clear instructions on how that class/method functions. Aurelia’s API docs are very minimal. Even adding links to the Guides page that explains its functionality and example code (and/or gist run example) would be a HUGE improvement.

[https://api.highcharts.com/highcharts/chart](https://api.highcharts.com/highcharts/chart)

---

<div class="post-metadata">

**Author:** ![tbnovaes](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/tbnovaes/32/147_2.png) [@tbnovaes](https://discourse.aurelia.io/u/tbnovaes)\
**Post date:** [November 29, 2017, 4:02pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/3 "2017-11-29T16:02:50Z")

</div>

Yes I use highcharts, and by looking the documentation for few minutes and checking the jsfiddle, you can confidently implement anything the api has to offer.

---

<div class="post-metadata">

**Author:** ![rkever](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/rkever/32/145_2.png) [@rkever](https://discourse.aurelia.io/u/rkever)\
**Post date:** [November 29, 2017, 4:09pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/4 "2017-11-29T16:09:00Z")

</div>

I do feel the Guides section is really coming along and is very easy to navigate and has lots of details with example snippets. I think the only thing there is that it tends to be missing newer features such as the new `each` attribute for `if.bind`. The API is hard to follow as it’s more the layout/structure of classes rather than documentation, which the Guides sections handles.

---

<div class="post-metadata">

**Author:** ![zewa666](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/zewa666/32/19_2.png) [@zewa666](https://discourse.aurelia.io/u/zewa666)\
**Post date:** [November 29, 2017, 6:00pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/5 "2017-11-29T18:00:42Z")

</div>

The great part about our documentation is that its built from Markdown files. Most of them are in aurelia/framework others spread amongst various other repos. So If you see something missing create a PR, that would help us endlessly.

---

<div class="post-metadata">

**Author:** ![tbnovaes](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/tbnovaes/32/147_2.png) [@tbnovaes](https://discourse.aurelia.io/u/tbnovaes)\
**Post date:** [November 29, 2017, 6:21pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/6 "2017-11-29T18:21:54Z")

</div>

Can you tell me more about this each attribute? @rkever

---

<div class="post-metadata">

**Author:** ![tbnovaes](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/tbnovaes/32/147_2.png) [@tbnovaes](https://discourse.aurelia.io/u/tbnovaes)\
**Post date:** [November 29, 2017, 6:25pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/7 "2017-11-29T18:25:10Z")

</div>

I would love to contribute, but I’m still trying to figure out the new things myself before being able to put something down. For example, there is no documentation for the if/else binding, so although I know it exists, I have no ideia how the syntax should be.

---

<div class="post-metadata">

**Author:** ![rkever](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.aurelia.io/rkever/32/145_2.png) [@rkever](https://discourse.aurelia.io/u/rkever)\
**Post date:** [November 29, 2017, 6:55pm UTC](https://discourse.aurelia.io/t/advanced-tutorials-documentation/447/8 "2017-11-29T18:55:36Z")

</div>

Sure, see this: [Else.bind documentation](https://discourse.aurelia.io/t/else-bind-documentation/455/2?u=rkever)
