after almost a year I declare the tutorial finished

Author: jbritain

src/content/docs/current/Guides/Your First Shader/0_intro.mdx

@@ -4,15 +4,8 @@ description: Get started creating your first shader
 sidebar:
   label: An Introduction to Shaders
   order: 1
-  badge:
-    text: In Development
-    variant: caution
 ---
 
-:::caution[Warning]
-This tutorial is still being developed. Some statements may be incorrect, and things may change in the future. Got any feedback? [Comment on the tracking issue](https://github.com/IrisShaders/DocsPage/issues/327).
-:::
-
 
 ## Foreward
 This tutorial is based on one written by [saadam1n](https://github.com/saadam1n/MinecraftShaderProgramming). This newer tutorial has been necessitated by the fact that since the tutorial was written, the general state of development on Minecraft shaders has advanced somewhat, and other developers have identified several areas where this can be improved.

src/content/docs/current/Guides/Your First Shader/1_composite.mdx

@@ -6,10 +6,6 @@ sidebar:
   order: 2
 ---
 
-:::caution[Warning]
-This tutorial is still being developed. Some statements may be incorrect, and things may change in the future. Got any feedback? [Comment on the tracking issue](https://github.com/IrisShaders/DocsPage/issues/327).
-:::
-
 ## Setting Up the File Structure
 Minecraft shaders require a specific structure of files in the right places to load code. While it's important to understand this structure, to save time, we will be working with the Base 330 pack from shaderLABS. Download it from [here](https://github.com/shaderLABS/Base-330), and extract it into your `shaderpacks` folder. You should have the following structure.
 

src/content/docs/current/Guides/Your First Shader/2_gbuffers.mdx

@@ -6,10 +6,6 @@ sidebar:
   order: 2
 ---
 
-:::caution[Warning]
-This tutorial is still being developed. Some statements may be incorrect, and things may change in the future. Got any feedback? [Comment on the tracking issue](https://github.com/IrisShaders/DocsPage/issues/327).
-:::
-
 In this next section, we will start with a fresh copy of the Base-330 pack, instead of using the grayscale version we made in the previous step. You could also just remove the lines you added to `composite.fsh`.
 
 For the purposes of this tutorial, we will only be covering the shading of terrain. Therefore, it is worth deleting all other files starting with `gbuffers_`. You can also get rid of the `deferred` files. You should now just have

src/content/docs/current/Guides/Your First Shader/3_composite_lighting.mdx

@@ -6,10 +6,6 @@ sidebar:
   order: 3
 ---
 
-:::caution[Warning]
-This tutorial is still being developed. Some statements may be incorrect, and things may change in the future. Got any feedback? [Comment on the tracking issue](https://github.com/IrisShaders/DocsPage/issues/327).
-:::
-
 In this section we will implement basic diffuse shading in the composite pass. As such, we will be primarily editing `composite.fsh`.
 
 ## Gamma Correction

src/content/docs/current/Guides/Your First Shader/4_shadows.mdx

@@ -6,10 +6,6 @@ sidebar:
   order: 4
 ---
 
-:::caution[Warning]
-This tutorial is still being developed. Some statements may be incorrect, and things may change in the future. Got any feedback? [Comment on the tracking issue](https://github.com/IrisShaders/DocsPage/issues/327).
-:::
-
 In this section we will implement basic shadow mapping which allows us to check if a pixel has a shadow cast on it.
 
 ## The `shadow` Pass

src/content/docs/current/Guides/Your First Shader/5_fog.mdx

@@ -6,10 +6,6 @@ sidebar:
   order: 5
 ---
 
-:::caution[Warning]
-This tutorial is still being developed. Some statements may be incorrect, and things may change in the future. Got any feedback? [Comment on the tracking issue](https://github.com/IrisShaders/DocsPage/issues/327).
-:::
-
 In this section we will implement depth based fog, so that things seem to fade into the distance.
 
 ## Another `composite` Pass

src/content/docs/current/Guides/Your First Shader/6_next_steps.mdx

@@ -6,30 +6,32 @@ sidebar:
   order: 5
 ---
 
-:::caution[Warning]
-This tutorial is still being developed. Some statements may be incorrect, and things may change in the future. Got any feedback? [Comment on the tracking issue](https://github.com/IrisShaders/DocsPage/issues/327).
-:::
-
 This is as far as we go with the tutorial, but there's plenty more that can be done with the shader!
 
 ## Issues to Fix
-### Transparent Entities
+### "Transparent" Entities
 ![](../../../../../assets/beginner_tutorial/transparententities.webp)
-Right now, our entities seem semitranslucent. This is because we have only written a `gbuffers_terrain` program. Entities are handled by `gbuffers_entities`, which falls back to `gbuffers_textured_lit`. Since we have not overriden this program, it doesn't write our normals or lightmap data to the buffers we need it to. An easy way to resolve this is to rename `gbuffers_terrain` to `gbuffers_textured_lit`, which most programs we care about will fall back to. For more information, see [Gbuffers](http://localhost:4321/current/reference/programs/gbuffers/).
+Right now, our entities appear partially translucent. This is because we have only written a `gbuffers_terrain` program. Entities are handled by `gbuffers_entities`, which falls back to `gbuffers_textured_lit`. Since we have not overriden this program, it doesn't write our normals or lightmap data to the buffers we need it to. An easy way to resolve this is to rename `gbuffers_terrain` to `gbuffers_textured_lit`, which most programs we care about will fall back to. For more information, see [Gbuffers](/current/reference/programs/gbuffers/).
 
 ### Bright Night
 Since our sunlight and skylight colors are constant, things are still very well lit at night. This can be improved by varying the skylight and sunlight colors based on the time of day. We can do this using the uniform [`worldTime`](/current/reference/uniforms/world#worldtime).
 
 ## Things to Do
 Here are some things you could try adding to your shader next. Some of these are more complex than others, and may require additional research into graphics programming.
+
+:::caution[Warning]
+**None of the resources linked to are Minecraft specific!** You will need to modify the code they provide quite significantly to make it work in your shaderpack. **Do not expect to be able to just copy and paste code and have it work**.
+:::
+
 - A custom sky, using a simple gradient based on the time of day, or even a physically based atmosphere
 - Waving water and foliage
 - Better shadow filtering, using [interleaved gradient noise](https://blog.demofox.org/2022/01/01/interleaved-gradient-noise-a-different-kind-of-low-discrepancy-sequence/) and a [Vogel disk](https://www.shadertoy.com/view/tddXWl)
 - A [tonemap](https://64.github.io/tonemapping/)
 - Clouds
 - Specular shading, using something like [Blinn-Phong shading](https://learnopengl.com/Advanced-Lighting/Advanced-Lighting) or at a more advanced level, the [Cook-Torrance BRDF](https://learnopengl.com/PBR/Theory)
-- Screen Space Reflections
-- Bloom
+- [Screen Space Ambient Occlusion (SSAO)](https://learnopengl.com/Advanced-Lighting/SSAO)
+- [Screen Space Reflections](https://lettier.github.io/3d-game-shaders-for-beginners/screen-space-reflection.html)
+- [Bloom](https://learnopengl.com/Advanced-Lighting/Bloom). Most modern packs do [bloom in HDR](https://learnopengl.com/Guest-Articles/2022/Phys.-Based-Bloom), which will require you to use a [floating point buffer format](current/reference/constants/buffer_format/) and store every "mip level" in a single texture.
 
 ## Resources
 - The [shaderLABS discord](https://discord.gg/RpzWN9S) has some resources on shader development, but also has channels where you can ask for help if you're stuck on something.