more logical doc mapping (#156)

docs/plugins/builders/helpers.rb

@@ -61,7 +61,7 @@ def docs_in_category(category)
   end
 
   def indexed_docs_by_category(category)
-    docs_in_category(category).sort_by { |doc| doc.data.doc_order }
+    docs_in_category(category).sort_by { |doc| doc.data.slug }
   end
 
   def on_github(page)

docs/src/_documentation/how_tos/make-every-form-remote-in-rails.md → docs/src/_documentation/how_tos/10-make-every-form-remote-in-rails.md

@@ -1,6 +1,6 @@
 ---
 title: Make Every Form a Remote Form in Rails
-doc_order: 40
+permalink: /make-every-form-remote-in-rails
 ---
 
 Rails has a special configuration for remote forms as of `v6.1` that

docs/src/_documentation/how_tos/programmatic-fetching-with-events.md → docs/src/_documentation/how_tos/20-programmatic-fetching-with-events.md

@@ -1,5 +1,6 @@
 ---
 title: Programmatically Fetch with events
+permalink: /programmatic-fetching-with-events
 ---
 
 Remember how I said earlier its just fetch? Well there are 3 additional

docs/src/_documentation/how_tos/use-js-erb.md → docs/src/_documentation/how_tos/30-use-js-erb.md

@@ -1,6 +1,6 @@
 ---
 title: Using .js.erb
-doc_order: 40
+permalink: /use-js-erb
 ---
 
 ## [Rails Configuration](#rails-configuration)

docs/src/_documentation/how_tos/prefetching.md → docs/src/_documentation/how_tos/40-prefetching.md

@@ -1,6 +1,6 @@
 ---
 title: Prefetching
-doc_order: 20
+permalink: /prefetching
 ---
 
 ## [Why should I prefetch?](#why-should-i-prefetch)

docs/src/_documentation/how_tos/integrate-cablecar.md → docs/src/_documentation/how_tos/50-integrate-cablecar.md

@@ -1,6 +1,6 @@
 ---
 title: Integrate CableCar
-doc_order: 10
+permalink: /integrate-cablecar
 ---
 
 ## [CableCar](#cablecar)

docs/src/_documentation/how_tos/integrate-turbo-streams.md → docs/src/_documentation/how_tos/60-integrate-turbo.md

@@ -1,6 +1,6 @@
 ---
-title: Integrate Turbo Streams with mrujs
-doc_order: 50
+title: Integrate Turbo with mrujs
+permalink: /integrate-turbo
 ---
 
 Mrujs ships with a plugin to automatically handle TurboStream responses.

docs/src/_documentation/how_tos/using-shoelace-with-mrujs.md → docs/src/_documentation/how_tos/70-using-shoelace-with-mrujs.md

@@ -1,6 +1,6 @@
 ---
-title: Using Shoelace with Mrujs
-doc_order: 70
+title: Using Shoelace with mrujs
+permalink: /using-shoelace-with-mrujs
 ---
 
 Mrujs ships with a Shoelace plugin. Currently this plugin is fairly minimal. At its

docs/src/_documentation/references/comparison-to-ujs.md → docs/src/_documentation/references/01-comparison-to-ujs.md

@@ -1,6 +1,6 @@
 ---
 title: Comparison to UJS
-doc_order: 10
+permalink: /comparison-to-ujs
 ---
 
 Before we start comparing, let's start with why.

docs/src/_documentation/references/remote_forms_and_links.md → docs/src/_documentation/references/02-remote-forms-and-links.md

@@ -1,6 +1,6 @@
 ---
 title: Understanding Remote Forms and Links
-doc_order: 20
+permalink: /remote-forms-and-links
 ---
 What are remote forms and links? When you see the word "Remote" referencing forms or links,
 it means the element is submitting its contents via "AJAX".

docs/src/_documentation/references/ajax_lifecycle.md → docs/src/_documentation/references/03-ajax-lifecycle.md

@@ -1,6 +1,6 @@
 ---
 title: Ajax Lifecycle
-doc_order: 30
+permalink: /ajax-lifecycle
 ---
 
 ## Events

docs/src/_documentation/references/mime_types.md → docs/src/_documentation/references/04-mime-types.md

@@ -1,6 +1,6 @@
 ---
 title: (Experimental) MimeTypes
-doc_order: 80
+permalink: /mime-types
 ---
 
 mrujs comes with a set of predefined MimeTypes for `AcceptHeaders`.

docs/src/_documentation/references/fetch.md → docs/src/_documentation/references/05-fetch.md

@@ -1,6 +1,6 @@
 ---
 title: The Fetch API
-doc_order: 50
+permalink: /fetch
 ---
 
 ## [Fetch](#fetch)

docs/src/_documentation/references/querySelectors.md → docs/src/_documentation/references/06-query-selectors.md

@@ -1,6 +1,6 @@
 ---
 title: (Experimental) QuerySelectors
-doc_order: 80
+permalink: /query-selectors
 ---
 
 mrujs comes with a number of preconstructed querySelectors. These can be

docs/src/_documentation/references/integrations.md → docs/src/_documentation/references/07-integrations.md

@@ -1,6 +1,6 @@
 ---
 title: Integrations
-doc_order: 90
+permalink: /integrations
 ---
 
 ## [Navigation](#navigation)

docs/src/_documentation/references/plugins.md → docs/src/_documentation/references/08-plugins.md

@@ -1,6 +1,6 @@
 ---
 title: (Experimental) Plugins
-doc_order: 60
+permalink: /plugins
 ---
 
 ## [Plugin Interface](#plugin-interface)

docs/src/_documentation/references/known_issues.md → docs/src/_documentation/references/09-known-issues.md

@@ -1,6 +1,6 @@
 ---
 title: Known Issues
-doc_order: 100
+permalink: /known-issues
 ---
 
 ## [Turbolinks Gem](#turbolinks-gem)

docs/src/_documentation/references/async_confirms.md → docs/src/_documentation/references/10-async-confirms.md

@@ -1,8 +1,15 @@
 ---
-title: (Experimental) Async Confirm Dialogs
-doc_order: 120
+title: (Deprecated) Async Confirm Dialogs
+permalink: /async-confirms
 ---
 
+<%= render(Alert.new(title: "Warning:", type: :warning)) do %>
+  <p>
+    Async confirms in their current state are deprecated until a more
+    stable API is put into place.
+  </p>
+<% end %>
+
 Mrujs offers an alternative to `window.confirm()` dialogs in the form of
 `data-async-confirm="<text>"` which will display a modal which will not block the
 main thread.

docs/src/_documentation/references/understanding-method-masking.md → docs/src/_documentation/references/11-understanding-method-masking.md

@@ -1,6 +1,6 @@
 ---
 title: Understanding Method Masking
-doc_order: 85
+permalink: /understanding-method-masking
 ---
 
 Mrujs has a special technique it uses for all links to use

docs/src/_documentation/tutorials/getting-started.md → docs/src/_documentation/tutorials/01-getting-started.md

@@ -1,6 +1,6 @@
 ---
 title: Getting Started
-doc_order: 10
+permalink: /getting-started
 ---
 
 ## [1. Install Mrujs](#1-install-mrujs)

docs/src/_documentation/tutorials/practical-guide-to-mrujs.md → docs/src/_documentation/tutorials/02-practical-guide-to-mrujs.md

@@ -1,6 +1,6 @@
 ---
 title: Practical Guide to mrujs
-doc_order: 20
+permalink: /practical-guide-to-mrujs
 ---
 
 If you're new to the concept of UJS, or want a practical example of what