More docs

_config.yml

@@ -4,7 +4,7 @@ theme: just-the-docs
 
 url: https://endorphin3d.com
 logo: "/assets/images/logo-text.png"
-favicon_ico: "/assets/images/logo.svg"
+favicon_ico: "/assets/images/favicon.ico"
 
 aux_links:
   Repository: https://github.com/endorphin3d/endorphin

_includes/docs-step.html

@@ -3,17 +3,14 @@
   <div style="flex: 1">
     {{ include.content | markdownify }}
   </div>
+  <div style="flex: 1">
   {% if include.image %}
-  <div style="flex: 1">
     <img src="{{ include.image }}" alt="{{ include.heading }}">
-  </div>
   {% endif %}
-
   {% if include.video %}
-  <div style="flex: 1">
     <video muted controls loop class="w-full">
       <source src="{{ include.video }}" type="video/mp4">
     </video>
-  </div>
   {% endif %}
+  </div>
 </div>

docs/firmware.md

@@ -1,39 +1,20 @@
 ---
 layout: default
-title: Getting Started
+title: Firmware
-nav_order: 1
+nav_order: 3
-permalink: docs/getting-started
+permalink: docs/firmware
 has_toc: false
 ---
 
-{% capture preface %}
+# Firmware
-The Endorphin uses a slightly different belt setup from the original Ender 5, known as a "Markforged kinematic" or Hybrid CoreXY. In this setup the X belt moves like a CoreXY but the Y axis remains in its original Ender 5 cartesian setup--one of the main reasons why the Endorphin is is so much faster to build than a CoreXY conversion.
-{% endcapture %}
-{% include docs-preface.html
-  title="# Getting Started"
-  image="/assets/images/docs/getting-started/belt-path.png"
-  content=preface
-%}
-
-{% capture kinematic %}
-Now, if you know anything about CoreXY machines you know that unlike cartesian printers, CoreXY printers don't have an "X stepper" or a "Y stepper" because a movement of one stepper affects both belts. In the Markforged kinematic, this is only partially the case:
-
-- The X stepper can move the printhead along the X axis by simply moving its belt while the Y belt stays stationary
-- The Y stepper only has to worry about moving the gantry linearly along the Y axis (cartesian style)
-- BUT when the Y stepper moves the gantry, the length of the X belt on either side of the gantry is affected and thus the X stepper must also move to compensate
-
-Luckily this kinematic is supported by both Klipper and the stock Marlin firmware (with a small modification).
-{% endcapture %}
-{% include docs-step.html
-  heading="#### Motion Diagram"
-  image="/assets/images/docs/getting-started/kinematic.png"
-  content=kinematic
-%}
-
-## Software
 
 {: .warning }
-Don't make these configuration changes until *AFTER* you've printed out all the parts for at least stage 1! You need a working printer (or a second printer) to get stage 1 off the ground.
+Don't make these changes until *AFTER* you've printed out all the parts for at least stage 1! You need a working printer (or a second printer) to get stage 1 off the ground.
+
+- TOC
+{:toc}
+
+---
 
 ### Klipper
 
@@ -73,4 +54,4 @@ Now you can continue following the Marlin guide on compiling the new firmware. O
 
 ---
 
-[Next →](/docs/stages){: .btn .btn-outline .fs-5 }
+[← Back](/docs/stages/stage-3){: .btn .btn-outline .mr-4 .fs-5 }

docs/introduction.md

@@ -0,0 +1,51 @@
+---
+layout: default
+title: Introduction
+nav_order: 1
+permalink: docs/introduction
+has_toc: false
+---
+
+{% capture preface %}
+In the last few years 3D printers have become blisteringly fast, pushing the limits of both heating and cooling while leaving those of us with printers like the Ender 5 feeling a bit left out of the fun. That ends now. Your Ender 5 is capable of being every bit as fast as a Voron without the hefty price tag. There have been [other](https://zerog.one) CoreXY [projects](https://www.printables.com/model/169131-ender-5-core-xy-with-linear-rails-mk3) to do a full conversion on the Ender 5, but often the price of parts or the complexity of the build makes it hard to justify over just buying something pre-built like a Bambulab P1P.
+
+**The Endorphin is different.** With a build you can do in an afternoon and parts that total less than $25, you no longer have any excuses *not* to turn Ender 5 into a speed demon. The difference is in the kinematic design.
+{% endcapture %}
+{% include docs-preface.html
+  title="# Introduction"
+  image="/assets/images/docs/getting-started/belt-path.png"
+  content=preface
+%}
+
+{% capture kinematic %}
+The Endorphin uses a slightly different belt setup from the original Ender 5, known as a "Markforged kinematic" or Hybrid CoreXY. In this setup the X belt moves like a CoreXY but the Y axis remains in its original Ender 5 cartesian setup.
+
+### Why Though?
+
+The basic idea is this: The less weight being thrown around, the faster the printer's acceleration/deceleration can be. Less weight also means higher top speeds because there will be less energy required to stop and change direction at the end of each move. This is why the CoreXY setup has become the choice of pretty much all high-speed printers such as the BambuLab, Voron, Ratrig, and HevORT.
+
+This project moves the X stepper motor off the gantry and onto the frame, where the Y steppers won't have to lug it around anymore. This is a significant amount of weight we're saving!
+
+Now, if you know anything about CoreXY machines you know that unlike cartesian printers, CoreXY printers don't have an "X stepper" or a "Y stepper" because a movement of one stepper affects both belts. In the Markforged kinematic, this is only partially the case:
+
+- The X stepper can move the printhead along the X axis by simply moving its belt while the Y belt stays stationary
+- The Y stepper only has to worry about moving the gantry linearly along the Y axis (cartesian style)
+- BUT when the Y stepper moves the gantry, the length of the X belt on either side of the gantry is affected and thus the X stepper must also move to compensate
+
+Luckily this kinematic is supported by both Klipper and the stock Marlin firmware (with a small modification). After you've printed the parts for at least stage 1, just follow the instructions in the [firmware section](/docs/firmware) to use the new kinematic.
+{% endcapture %}
+{% include docs-step.html
+  heading="## Kinematic"
+  image="/assets/images/docs/getting-started/kinematic.png"
+  content=kinematic
+%}
+
+## Q&A
+
+### What about the Ender 5 Plus?
+
+This hasn't been tested yet, but assuming you get longer rails and belts, this should work just fine without having to modify any of the printed parts. If anyone with an E5+ wants to test this and report their findings as a Github issue, it would be very welcome.
+
+---
+
+[Next →](/docs/stages){: .btn .btn-outline .fs-5 }

docs/stages/stage-2.md

@@ -22,9 +22,9 @@ permalink: docs/stages/stage-2
 
 #### Linear Rails
 
-| Size         | Length | Quantity | Link                                                   |
+| Size         | Length | Quantity | Link                                                                                                                                                                                      |
-| :----------- | :----- | :------- | :----------------------------------------------------- |
+| :----------- | :----- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| MGN12H Rails | 300mm  | 2        | [Amazon](https://www.amazon.com/gp/product/B09QPCTYDM) |
+| MGN12H Rails | 300mm  | 2        | [Amazon](https://www.amazon.com/gp/product/B09QPCTYDM), [Fabreeko](https://www.fabreeko.com/collections/honeybadger/products/honeybadger-mgn12h-black-steel-rails?variant=43180991545599) |
 
 #### Bolts
 

docs/stages/stage-3.md

@@ -22,9 +22,12 @@ permalink: docs/stages/stage-3
 
 #### Linear Rails
 
-| Size       | Length | Quantity | Link                                                   |
+| Size       | Length | Quantity | Link                                                                                                                                                                                     |
-| :--------- | :----- | :------- | :----------------------------------------------------- |
+| :--------- | :----- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| MGN9H Rail | 400mm  | 1        | [Amazon](https://www.amazon.com/gp/product/B09XQ7YWPT) |
+| MGN9H Rail | 400mm  | 1        | [Amazon](https://www.amazon.com/gp/product/B09XQ7YWPT), [Fabreeko](https://www.fabreeko.com/collections/honeybadger/products/honeybadger-mgn9h-black-steel-rails?variant=43180948685055) |
+
+{: .note }
+You actually only need a 350mm rail, but if you want to upgrade to stage 4 (coming soon) in which we'll be dropping the entire 2020 extrusion on the gantry, you'll want 400mm. It's up to you.
 
 #### Bolts
 
@@ -46,7 +49,7 @@ permalink: docs/stages/stage-3
 
 ### Belt Clips
 
-Either of the following belt clips provided with the printhead will work fine so pick whichever one you prefer. The original Vz printhead has been modified so that the posts sit at the right height for the Endorphin belts. Just remember that you only need to print off clips for 2 belt ends rather than the 4 needed in a CoreXY which means you can choose whether you want to attach the belt ends on the front or rear posts. The other two will be unused.
+Either of the following belt clips provided with the printhead will work fine so pick whichever one you prefer. The original Vz printhead has been modified so that the posts sit at the right height for the Endorphin belts. Just remember that you only need to print off clips for 2 belt ends rather than the 4 needed in a CoreXY, which means you can choose whether you want to attach the belt ends on the front or rear posts. The other two will be unused.
 {: .mb-8 }
 
 {% capture belts1 %}
@@ -70,16 +73,21 @@ This is a two-part clip that has more intricate details to print, so make sure t
 {% capture eva %}
 **Usable Print Area:** 220 x 190 (30mm reduction on Y axis)
 
-The EVA printhead is the standard Ratrig printhead. It has a huge number of official addons including fan ducts, hotends, and extruders as well as [even more](https://www.printables.com/search/models?q=tag:eva3) parts created by the community. The main downside of this printhead is the size causes about 10mm more lost print space on the Y axis than the Vz.
+The EVA printhead is the standard Ratrig printhead. It has a large number of official addons including fan ducts, hotends, and extruders as well as [even more](https://www.printables.com/search/models?q=tag:eva3) parts created by the community. The main downside of this printhead is that its size causes about 10mm more lost print space on the Y axis than the Vz.
 
-The official EVA v3 design only required two parts to be modified in order to work on the Endorphin, so you can start by reading up on the official [CoreXY printhead](https://main.eva-3d.page/heat_insert/core/corexy) and download most of the parts from this page. Just substitute the following parts for the Endorphin versions in this table:
+The official EVA v3 design only required three parts to be modified in order to work on the Endorphin, so you can start by reading up on the official [CoreXY printhead](https://main.eva-3d.page/heat_insert/core/corexy) and downloading most of the parts from this page. Just substitute the following parts for the Endorphin versions in this table:
 
-| Original Part            | Link                                                                                     |
+| Original Part            | Endorphin Part                                                                           |
 | :----------------------- | :--------------------------------------------------------------------------------------- |
 | back_core_xy_fi.stl      | [back_endorphin.stl](/assets/stl/docs/stages/stage-3/back_endorphin.stl)                 |
 | core_xy_belt_grabber.stl | [endorphin_belt_grabber.stl](/assets/stl/docs/stages/stage-3/endorphin_belt_grabber.stl) |
+| top_endstop_mgn12c_fi    | [eva-mgn9h.stl](/assets/stl/docs/stages/stage-3/eva-mgn9h.stl)                           |
 
-You also don't need to print `face_belt_grabber.stl` because the Endorphin doesn't have a belt that attaches to the front of the EVA in the same way that the CoreXY does.
+You also don't need to print `face_belt_grabber.stl` because the Endorphin doesn't have a belt that attaches to the front of the EVA in the same way that a CoreXY does.
+
+After you've printed the core printhead, you can choose the fan duct, hotend, and extruder that suits you. If you don't see your preferred parts on the official site, make sure to check sites like [printables](https://www.printables.com/search/models?q=tag:eva3) for what you need.
+
+Credit for `eva-mgn9h.stl` goes to [@andbou_260448](https://www.printables.com/model/209376-eva-30-heat-set-mgn-9h-top-endstop)
 
 {% endcapture %}
 {% include docs-step.html
@@ -98,4 +106,4 @@ You also don't need to print `face_belt_grabber.stl` because the Endorphin doesn
 
 ---
 
-[← Back](/docs/stages/stage-2){: .btn .btn-outline .mr-4 .fs-5 }
+[← Back](/docs/stages/stage-2){: .btn .btn-outline .mr-4 .fs-5 } [Next →](/docs/firmware){: .btn .btn-outline .fs-5 }

docs/stages/stages.md

@@ -12,9 +12,6 @@ has_toc: false
 {: .fs-5 .fw-300 }
 Endorphin was designed to be progressively upgraded--so you can get started with minimal cost and time, then upgrade further if you wish. Each stage will drop more moving weight, but will also require more materials and printed parts.
 
-> Note: Weight reduction and cost of each stage are listed separately--rather than cumulatively--to the stage(s) before it. Grand totals of all the stages are added up in the final row.
-{: .fs-4 .fw-300 }
-
 | Stage     | Moving Weight Reduction | Cost    |
 | :-------- | :---------------------- | :------ |
 | 1         | 215g                    | $21     |
@@ -22,8 +19,11 @@ Endorphin was designed to be progressively upgraded--so you can get started with
 | 3         | 90g[^1]                 | $16     |
 | **Total** | **575g**                | **$75** |
 
+> Note: Weight reduction and cost of each stage are listed relative to the stage before it (rather than cumulatively). Grand totals of all the stages are added up in the final row of this table:
+{: .fs-4 .fw-300 }
+
 ---
 
 [← Back](/docs/getting-started){: .btn .btn-outline .mr-4 .fs-5 } [Next →](/docs/stages/stage-1){: .btn .btn-outline .fs-5 }
 
-[^1]: Because stage 3 adds a linear rail to the X axis, the weight of the new rail does negate the weight saved by dropping the v-slot printhead carriage. This stage isn't as much about dropping weight as the other two stages were. The benefits of this stage are mainly more print consistency on the X axis, access to the awesome Ratrig and Vz printheads, and complete liberation from those frustrating v-slot wheels.
+[^1]: Because stage 3 adds a linear rail to the X axis, the weight of the new rail does negate the weight saved by dropping the v-slot printhead carriage.