# Templates, guides, calibration

**URL:** <https://forums.maslowcnc.com/t/templates-guides-calibration/4258>\
**Category:** Technical Details\
**Created:** [June 6, 2018, 5:27pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258 "2018-06-06T17:27:36Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![xrok1](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/xrok1/32/19640_2.png) [@xrok1](https://forums.maslowcnc.com/u/xrok1)\
**Post date:** [June 6, 2018, 5:27pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/1 "2018-06-06T17:27:37Z")

</div>

Hi is there a dedicated thread where all the details for when I receive my machine, putting together, calibrate, trouble shoot…?  
If not I would like to suggest it. Make it proud and sticky. lol

---

<div class="post-metadata">

**Author:** ![dlang](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/dlang/32/859_2.png) [@dlang](https://forums.maslowcnc.com/u/dlang)\
**Post date:** [June 7, 2018, 1:09am UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/2 "2018-06-07T01:09:59Z")

</div>

There is the set of instructions on the wiki that should include all of that.

---

<div class="post-metadata">

**Author:** ![jwolter](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/jwolter/32/30787_2.png) [@jwolter](https://forums.maslowcnc.com/u/jwolter)\
**Post date:** [June 7, 2018, 2:33pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/3 "2018-06-07T14:33:09Z")

</div>

> **[MaslowCNC/Mechanics](https://github.com/MaslowCNC/Mechanics/wiki)**
>
> Digital Design Files. Contribute to MaslowCNC/Mechanics development by creating an account on GitHub.

---

<div class="post-metadata">

**Author:** ![jwolter](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/jwolter/32/30787_2.png) [@jwolter](https://forums.maslowcnc.com/u/jwolter)\
**Post date:** [June 7, 2018, 2:35pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/4 "2018-06-07T14:35:22Z")

</div>

Hey @bar, at the top of the screen here on the forums are green buttons for the Maslow website and the Community Garden. Could we add one for the wiki?

---

<div class="post-metadata">

**Author:** ![bar](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/bar/32/10_2.png) [@bar](https://forums.maslowcnc.com/u/bar)\
**Post date:** [June 7, 2018, 4:58pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/5 "2018-06-07T16:58:20Z")

</div>

Absolutely! Which page should it send folks to?

---

<div class="post-metadata">

**Author:** ![mrfugu](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/mrfugu/32/22_2.png) [@mrfugu](https://forums.maslowcnc.com/u/mrfugu)\
**Post date:** [June 8, 2018, 3:08pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/6 "2018-06-08T15:08:49Z")

</div>

If there is any possibility of a single Wiki installation (perhaps within Discourse? or as a module to the core [maslowcnc.com](http://maslowcnc.com) domain?) vs. the current Status Quo, it would really be easier.

As it stands, ([https://github.com/MaslowCNC/Mechanics/wiki](https://github.com/MaslowCNC/Mechanics/wiki)) is the ‘home page’ of the 5 wiki’s each (loosely) focused on the github sub-projects.

“This is cumbersome and you should feel burdened by it”, to borrow a phrase from Futurama…

---

<div class="post-metadata">

**Author:** ![bar](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/bar/32/10_2.png) [@bar](https://forums.maslowcnc.com/u/bar)\
**Post date:** [June 8, 2018, 5:12pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/7 "2018-06-08T17:12:49Z")

</div>

I agree!

The current wiki seems like it’s a little difficult to use because it’s so spread out and hidden.

Would using the discourse wiki features be a good idea?

> **[What is a Wiki Post?](https://meta.discourse.org/t/what-is-a-wiki-post/30801)**
>
> What is a wiki post? A wiki post/admin wiki post is a special type of post that can be edited by any user on your forum. How do I create (or remove) a wiki post? To turn a regular post into a wiki post you usually need moderator/admin privileges. ...

Or something more like this in the garden?

> **[Using Discourse as a community-powered wiki](https://blog.discourse.org/2016/05/using-discourse-as-a-community-powered-wiki/)**
>
> The following is a guest post by Sam Nazarko, CEO and founder of OSMC.tv Are you using Discourse in a novel way? If you’re interested in writing a guest post like this one, please get in touch. In 2014, I started working on a new project, OSMC (Open...

---

<div class="post-metadata">

**Author:** ![mrfugu](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/mrfugu/32/22_2.png) [@mrfugu](https://forums.maslowcnc.com/u/mrfugu)\
**Post date:** [June 8, 2018, 5:49pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/8 "2018-06-08T17:49:02Z")

</div>

Wiki posts looks like the easiest one to implement, but you’d know better than I. No activity in ~2 yrs on the 2nd option…

If Discourse allows like 6-8 levels of Forum/Topic hierarchy, that should do it.

Thinking through things, here are some points before heading in a new direction/duplication:

The current wiki does work, is easy to edit and can suit all needs well but It’s major problems are:

- Discourse doesn’t read the Wiki page name into the forum, it reads Github’s title for the project section, which isn’t providing an accurate summary of any linked page or subsection of a page. Forum links to the wiki don’t make it easy to get to and fro between discussion and (possible) solution (or contribution).

- Github Wiki is keyed to the code project titles, this doesn’t provide adequate direct compartmentalization for CNC and Maslow related topics (ex: is G-Code Output intrepretation ‘Firmware’ or ‘GroundControl’, what about Frames? Mechanics?)

- The Github Wiki has fallen well behind the Forums in current development and best available information (especially bits and materials imho) It will typically always be somewhere behind the forums, but currently needs some attention to bring it up to a more current ‘collective awareness’ of problems and solutions.

- Contributors need to be Github users. This is probably a good filter preventing casual wiki additions, and (I’m not volunteering, mind you) assigning some moderators to comb through the forums and add Wiki content regularly would work well to keep things up to speed.

if we could solve the Discourse-page summary situation we’d probably not need to do more than what already needs doing: updating the wiki to the current state of affairs (inc kit changes, board revisions, etc.)

---

<div class="post-metadata">

**Author:** ![dlang](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/dlang/32/859_2.png) [@dlang](https://forums.maslowcnc.com/u/dlang)\
**Post date:** [June 8, 2018, 7:08pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/9 "2018-06-08T19:08:36Z")

</div>

on the one hand, a unified wiki would be good, on the other hand, using a wiki  
tied closely with the code/repo content is also useful.

I think that what we may really want is a wiki somewhere (possibly in github,  
possibly not), that is used for the completed machine and everything related to  
it, and that will let us leave the existing wikis to be tied closely with the  
specific components (so that if/when we change components, say the new motor  
controller board design), we don’t end up dragging a lot of old stuff in with  
the new stuff.

---

<div class="post-metadata">

**Author:** ![dlang](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/dlang/32/859_2.png) [@dlang](https://forums.maslowcnc.com/u/dlang)\
**Post date:** [June 8, 2018, 7:24pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/10 "2018-06-08T19:24:44Z")

</div>

> If Discourse allows like 6-8 levels of Forum/Topic hierarchy, that should do it.

I don’t like forums replacing the wiki, things age out too fast in forums and  
it’s too hard to hunt for old data.

> Thinking through things, here are some points before heading in a new direction/duplication:
> 
> The current wiki does work, is easy to edit and can suit all needs well but It’s major problems are:
> 
> - Discourse doesn’t read the Wiki page name into the forum, it reads Github’s  
> title for the project section, which isn’t providing an accurate summary of  
> any linked page or subsection of a page. Forum links to the wiki don’t make it  
> easy to get to and fro between discussion and (possible) solution (or  
> contribution).

fair, but is this a problem with discource or the wiki?

> - Github Wiki is keyed to the code project titles, this doesn’t provide  
> adequate direct compartmentalization for CNC and Maslow related topics (ex: is  
> G-Code Output intrepretation ‘Firmware’ or ‘GroundControl’, what about Frames?  
> Mechanics?)

This is the biggest problem IMHO with the wikis tied to the different  
repositories

> - The Github Wiki has fallen well behind the Forums in current development and  
> best available information (especially bits and materials imho) It will  
> typically always be somewhere behind the forums, but currently needs some  
> attention to bring it up to a more current ‘collective awareness’ of problems  
> and solutions.

this is not a technology thing, but a community culture thing. We need to tie  
the wiki in to the community flow so that it’s easy to update and have  
discussions about it.

> - Contributors need to be Github users. This is probably a good filter  
> preventing casual wiki additions, and (I’m not volunteering, mind you)  
> assigning some moderators to comb through the forums and add Wiki content  
> regularly would work well to keep things up to speed.

again, not a technology problem, whatever system we use will require people to  
have accounts for it, and there is always a problem with getting things from  
forums, mailing lists into the wiki

\<soapbox.

I think the ideal situation would be something sort of resembling the community  
garden. A wiki page that can be edited, host images, etc and then one or more  
linked forum threads referencing the pages (potentially a many ↔ many mapping)  
so that someone going to a page can see the discussions on the topic, and  
someone stumbling onto a topic has a trivial way to get to the relevant pages  
(and from there to other, similar discussion)

I don’t know if there is anything out there that does this well.

David Lang

---

<div class="post-metadata">

**Author:** ![xrok1](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/xrok1/32/19640_2.png) [@xrok1](https://forums.maslowcnc.com/u/xrok1)\
**Post date:** [June 15, 2018, 4:24am UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/11 "2018-06-15T04:24:54Z")

</div>

I see the firmware, ground control, and sled are on the garden. Why not just add the frame and a trouble shooting guide there?

---

<div class="post-metadata">

**Author:** ![bar](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/bar/32/10_2.png) [@bar](https://forums.maslowcnc.com/u/bar)\
**Post date:** [June 15, 2018, 4:23pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/12 "2018-06-15T16:23:46Z")

</div>

That is a great idea! I’ll work on getting the frame posted, does someone else want to take on posting the trouble shooting guide?

What picture would we put for the trouble shooting guide?

---

<div class="post-metadata">

**Author:** ![dlang](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/dlang/32/859_2.png) [@dlang](https://forums.maslowcnc.com/u/dlang)\
**Post date:** [June 15, 2018, 6:42pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/13 "2018-06-15T18:42:03Z")

</div>

there is a section in the wiki that shows pictures of bad cuts and what the  
problem is.

the recent thread working on testing in the bottom corner produced several more  
really good pictures.

---

<div class="post-metadata">

**Author:** ![xrok1](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/xrok1/32/19640_2.png) [@xrok1](https://forums.maslowcnc.com/u/xrok1)\
**Post date:** [June 23, 2018, 2:08pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/14 "2018-06-23T14:08:39Z")

</div>

Any progress on this?

---

<div class="post-metadata">

**Author:** ![bar](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/bar/32/10_2.png) [@bar](https://forums.maslowcnc.com/u/bar)\
**Post date:** [June 25, 2018, 3:23pm UTC](https://forums.maslowcnc.com/t/templates-guides-calibration/4258/15 "2018-06-25T15:23:07Z")

</div>

> [@bar](#):
>
> That is a great idea! I’ll work on getting the frame posted,

The frames are posted in the garden now, but I have not had a chance to do a trouble shooting guide yet