some cleaning and more docs

Author: doomy

config.toml

@@ -13,7 +13,7 @@ highlight_theme = "ir-white"
 # Whether to build a search index to be used later on by a JavaScript library
 build_search_index = true
 
-title = "RustAudio"
+title = "Rust Audio"
 
 taxonomies = [
 ]

content/formats.toml

@@ -1,18 +1,38 @@
 # Audio plugin formats
 
+# Format for specifying a format 🤔
+#
+# ```
+# [[formats]]
+#
+# # Human readable format name
+# name = "MyFormatName"
+#
+# # Short synopsis of the format
+# description = "This format was designed for Plan9 computers only"
+#
+# # Whether or not the format is permissively licensed
+# proprietary = false
+#
+# # Optionally, list crates that work with this format
+# crates = [
+#     { name = "plan9-plug", url = "https://example.com/mycoolsite/plan9-plugin" },
+# ]
+#
+# # Optionally, list additional resources on this format
+# resources = [
+#    { name = "My link docs name", url = "http://example.com/docs" },
+# ]
+# ```
+
 [[formats]]
-# Human readable format name
 name = "VST"
-# Short synopsis of the format
 description = "VST2 was one of the most common standards, but is now unlicensed. Instead, VST3 is recommended. VSTs are generally supported in most DAWs."
-# Whether or not the format is permissively licensed
 proprietary = true
-# Optional crates that work with this format
 crates = [
     { name = "vst", url = "https://github.com/RustAudio/vst-rs" },
     { name = "vst3-sys", url = "https://github.com/RustAudio/vst3-sys" },
 ]
-# Optional additional resources on this format
 resources = []
 
 [[formats]]

content/resources.toml

@@ -1,3 +1,18 @@
+# Resources format
+#
+# ```
+# [[resources]]
+#
+# A descriptive but short name for the resource
+# name = "My resource name"
+#
+# # Link directly to the resource named
+# url = "http://www.example.com/dsp.html"
+#
+# # Avoid creating new categories unless completely necessary
+# category = "general"
+# ```
+
 [[resources]]
 name = "The Scientist and Engineer's Guide to Digital Signal Processing"
 url = "http://www.dspguide.com/"

templates/index.html

@@ -25,7 +25,7 @@ <h3>Community</h3>
     <div style="display: flex; gap: 2em;">
         <div style="display: flex; flex-direction: column;">
             <h4 style="margin: 0;">Discord</h4>
-            <p>Join RustAudio on Discord to keep up with audio development within the Rust ecosystem, get help with
+            <p>Join Rust Audio on Discord to keep up with audio development within the Rust ecosystem, get help with
                 DSP, collaborate on projects, and everything in-between.
                 </br>
                 <a class="button" style="margin-top: 1em" href={{config.extra.discord_invite}} target="_blank">Join
@@ -108,7 +108,8 @@ <h2>{{group | capitalize}}</h2>
 {# Crates #}
 
 <section>
-    <h2 class="container-full">RustAudio Crates</h2>
+    <h2>Projects</h2>
+    <h2 class="container-full">Rust Audio Crates</h2>
     <div class="crates">
         {% set crates = load_data(url=config.extra.repos_url, format="json") %}
         {% for crate in crates | sort(attribute="updated_at") | reverse %}