# Editing documentation: how to use further-reading metadata?

**URL:** <https://forum.babylonjs.com/t/editing-documentation-how-to-use-further-reading-metadata/24544>\
**Category:** Questions\
**Created:** [October 13, 2021, 2:05pm UTC](https://forum.babylonjs.com/t/editing-documentation-how-to-use-further-reading-metadata/24544 "2021-10-13T14:05:48Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Vinc3r](https://sea2.discourse-cdn.com/flex024/user_avatar/forum.babylonjs.com/vinc3r/32/25340_2.png) [@Vinc3r](https://forum.babylonjs.com/u/Vinc3r)\
**Post date:** [October 13, 2021, 2:05pm UTC](https://forum.babylonjs.com/t/editing-documentation-how-to-use-further-reading-metadata/24544/1 "2021-10-13T14:05:48Z")

</div>

I’ve noticed we now have a `further-reading` metadata, mentionned in the doc’, but we’re missing the format of this content: [Contribute To The Documentation | Babylon.js Documentation](https://doc.babylonjs.com/divingDeeper/developWithBjs/contributeToDocs#further-reading)

I’ve guessed that we need an array, but after some tests I was just able to copy a link:

```markdown
---
title: Lens Flares
image: 
description: Yep yep yep
keywords: yep, yep, yep
further-reading: ["https://mylink.com", "https://mylink.fr"]
video-overview:
video-content:
---

```

Is there a way to show a description instead of the link itself for example? (in the same way as markdown: `[description](http://myurl.com)`

> <https://github.com/Vinc3r/BabylonJS-Documentation/blob/master/content/How_To/environment/How_to_use_Lens_Flares.md?plain=1#L6>

---

<div class="post-metadata">

**Author:** ![sebavan](https://sea2.discourse-cdn.com/flex024/user_avatar/forum.babylonjs.com/sebavan/32/57_2.png) [@sebavan](https://forum.babylonjs.com/u/sebavan)\
**Post date:** [October 13, 2021, 2:19pm UTC](https://forum.babylonjs.com/t/editing-documentation-how-to-use-further-reading-metadata/24544/2 "2021-10-13T14:19:14Z")

</div>

@PirateJC will hate me today but this is definitely for him 🙂

---

<div class="post-metadata">

**Author:** ![PirateJC](https://sea2.discourse-cdn.com/flex024/user_avatar/forum.babylonjs.com/piratejc/32/1003_2.png) [@PirateJC](https://forum.babylonjs.com/u/PirateJC)\
**Post date:** [October 14, 2021, 3:54pm UTC](https://forum.babylonjs.com/t/editing-documentation-how-to-use-further-reading-metadata/24544/3 "2021-10-14T15:54:07Z")

</div>

This one is 100% my fault. I’ll add the desired format in the contribution doc right now. Sorry about that.

If you reference this page: [Node Material | Babylon.js Documentation](https://doc.babylonjs.com/divingDeeper/materials/node_material/nodeMaterial)

It has a live example of the format for the further-reading section:

 ![image](https://us1.discourse-cdn.com/flex024/uploads/babylonjs/original/3X/0/a/0a5ddf6a92b5ae77bd46ec0332e5a163f718d14f.png)

Again, sorry that that wasn’t in the contribution doc. Adding it now!

---

<div class="post-metadata">

**Author:** ![PirateJC](https://sea2.discourse-cdn.com/flex024/user_avatar/forum.babylonjs.com/piratejc/32/1003_2.png) [@PirateJC](https://forum.babylonjs.com/u/PirateJC)\
**Post date:** [October 14, 2021, 3:56pm UTC](https://forum.babylonjs.com/t/editing-documentation-how-to-use-further-reading-metadata/24544/4 "2021-10-14T15:56:03Z")

</div>

Ah I lied! Past @RaananW is much smarter than present @PirateJC!

There’s actually already an example of the metadata in this doc:

> **[Contribute To The Documentation | Babylon.js Documentation](https://doc.babylonjs.com/divingDeeper/developWithBjs/contributeToDocs#page-metadata)**
>
> Learn how to contribute to the Babylon.js Documentation.

---

<div class="post-metadata">

**Author:** ![PirateJC](https://sea2.discourse-cdn.com/flex024/user_avatar/forum.babylonjs.com/piratejc/32/1003_2.png) [@PirateJC](https://forum.babylonjs.com/u/PirateJC)\
**Post date:** [October 14, 2021, 4:01pm UTC](https://forum.babylonjs.com/t/editing-documentation-how-to-use-further-reading-metadata/24544/5 "2021-10-14T16:01:21Z")

</div>

I just made an edit to the further reading section of that page to reference the metadata section of the page. Hopefully that will help anyone in the future who may run into the same confusion.

> <https://github.com/BabylonJS/Documentation/pull/352>