# Documenting Maslow - what am I missing? **URL:** \ **Category:** Uncategorized\ **Tags:** documentation, adoption\ **Created:** [May 28, 2020, 4:07pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537 "2020-05-28T16:07:43Z")\ **Posts on this page:** 20\ **Page:** 2
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 3:07pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/21 "2020-06-01T15:07:09Z")
Hmm… sent it to the gmail address I’ve been using to communicate with you… just re-sent it… ---
**Author:** ![madgrizzle](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/madgrizzle/32/1372_2.png) [@madgrizzle](https://forums.maslowcnc.com/u/madgrizzle)\ **Post date:** [June 1, 2020, 3:08pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/22 "2020-06-01T15:08:27Z")
That email isn’t tied to my github user account (use a different one for that). I’ve joined the hackmd thing using github… can you add @madgrizzle that way? ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 3:10pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/23 "2020-06-01T15:10:08Z")
Oh, cool! I found you both via github usernames. You should both have access via Github-linked accounts now. ---
**Author:** ![madgrizzle](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/madgrizzle/32/1372_2.png) [@madgrizzle](https://forums.maslowcnc.com/u/madgrizzle)\ **Post date:** [June 1, 2020, 3:19pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/24 "2020-06-01T15:19:50Z")
Ok, seems that I can push a file to a specific branch. I pushed one of the notes to experimental branch under docs/test. You can not push? Maybe you need to be added to the maintainers to do it? Do you use github for hackmd login? ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 3:23pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/25 "2020-06-01T15:23:53Z")
Both Pull and Push open a dialog that asks me to select the Github repo, but that list is empty. When I click “Authorize more repos” it takes me to the “Update HackMD’s Repository Access” on Github. I can see that the repo is “installed” there. Attempting to connect it again gives the ownership error. Uncertain if I should be able to push/pull from a repo I’m not owner of… ---
**Author:** ![madgrizzle](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/madgrizzle/32/1372_2.png) [@madgrizzle](https://forums.maslowcnc.com/u/madgrizzle)\ **Post date:** [June 1, 2020, 3:36pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/26 "2020-06-01T15:36:56Z")
I made you a member of maintainer team… try again. ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 3:40pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/27 "2020-06-01T15:40:11Z")
It still says “This action must be performed by an organization owner.” Sigh. I emailed their support. ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 3:44pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/28 "2020-06-01T15:44:13Z")
Ah, I see part of the problem. We have a sub-team called “Maintainers.” But that does not imply any sort of “Maintainer Role.” If you click on Roles in the People list, you’ll see that nobody actually has the Maintainer **permission**. ---
**Author:** ![madgrizzle](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/madgrizzle/32/1372_2.png) [@madgrizzle](https://forums.maslowcnc.com/u/madgrizzle)\ **Post date:** [June 1, 2020, 3:58pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/29 "2020-06-01T15:58:52Z")
Are you sure? I checked the settings and for each repo, the maintainer team has maintainer permission… ![image](https://canada1.discourse-cdn.com/flex031/uploads/maslowcnc/original/3X/7/0/70d078944e816a7e23d94819e6292da3c1316f8c.png) ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 4:44pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/30 "2020-06-01T16:44:41Z")
Huh. You’re right. I guess it really does need to be “Owner” privs. You can also see it knows that the HackMD app is installed 🤷🏻‍♂️ I guess if you import all the docs, we can at least edit them in HackMD, then you can publish them via PR when we’re happy? Or maybe their support will get back to me. ![Screen Shot 2020-06-01 at 10.43.16 AM](https://canada1.discourse-cdn.com/flex031/uploads/maslowcnc/original/3X/b/9/b9fd8b6a246d2979c3ca1fa7bcc77ef380fa06b5.png) ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 4:48pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/31 "2020-06-01T16:48:15Z")
Or if you really trusted us, you could make us [organization owners too](https://github.com/orgs/WebControlCNC/people?query=). Whatever’s easiest for you. ![Screen Shot 2020-06-01 at 10.47.16 AM](https://canada1.discourse-cdn.com/flex031/uploads/maslowcnc/original/3X/9/1/9119d1390ce02cc4bfaf1262764599ff8108f37f.png) ---
**Author:** ![madgrizzle](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/madgrizzle/32/1372_2.png) [@madgrizzle](https://forums.maslowcnc.com/u/madgrizzle)\ **Post date:** [June 1, 2020, 5:45pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/32 "2020-06-01T17:45:27Z")
I pulled the index.md file in… > However, it doesn’t seem to render correctly… something with how the screenshot is handled (can hackmd handle images at all?) Take a look at it, it’s titled “Home”. It shows up fine in github pages (and pretty sure its fine in webcontrol off-line help). ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 6:00pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/33 "2020-06-01T18:00:41Z")
The image paths need to be absolute in the markdown if the images aren’t also hosted by the same site. So the path “assets/Screenshot.png” works fine on github because the assets folder exists and contains Screenshot.png. I’m guessing y’all did it this way because it also works on WebControl’s UI, because we ship the assets folder as part of the WebControl, which means that you can then serve relative paths (rather than contacting the internet for the assets). Anyways, my recommendation would be to use absolute paths in the docs and github, and then use a CI build script to turn them into relative paths during the deployment process. Shouldn’t be hard. ---
**Author:** ![cmullins70](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/cmullins70/32/6194_2.png) [@cmullins70](https://forums.maslowcnc.com/u/cmullins70)\ **Post date:** [June 1, 2020, 6:53pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/34 "2020-06-01T18:53:04Z")
I am more interested in documenting all things Maslow than WebControl specifically (although that is now a very important component). Are there any concerns that this doc should reside somewhere “higher” such as the Maslow CNC repo? Who owns that? I assume it is actively maintained? ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 6:58pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/35 "2020-06-01T18:58:59Z")
Bar (whose approval we received earlier in the thread) is who you’re looking for. To summarize my understanding: - WebControl will be the recommended app; GroundControl will likely fade away. - Calibration and WebControl-specific things should be in the WebControl tutorials. - The [frame build](https://www.maslowcnc.com/assemblyguide) is also on github (Maslow Community Garden), which is the “onboarding start here” point. I believe Bar can also approve those PRs. What I’m unsure about: - Things on [https://www.maslowcnc.com/](https://www.maslowcnc.com/) like the [assemblyguide](https://www.maslowcnc.com/assemblyguide) - Things shipped in the Maslow kits themselves. ---
**Author:** ![cmullins70](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/cmullins70/32/6194_2.png) [@cmullins70](https://forums.maslowcnc.com/u/cmullins70)\ **Post date:** [June 1, 2020, 7:03pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/36 "2020-06-01T19:03:08Z")
I a believer in “the perfect is the enemy of the good”, so I’ll continue on here for now unless there are objections, then we can move sections as we deem appropriate. @madgrizzle I don’t want to pollute your build with out-of-context info. Any issue with proceeding here? ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 7:06pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/37 "2020-06-01T19:06:55Z")
I chose HackMD because I was under the impression we could manage multiple repositories within a single team. We now have a HackMD team “Maslow.” We could apply a tag based upon which Github repository which each Markdown file belongs to. Then, I’m under the impression the owner can simply make a PR from the HackMD UI and accept it into their own upstream. ---
**Author:** ![cmullins70](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/cmullins70/32/6194_2.png) [@cmullins70](https://forums.maslowcnc.com/u/cmullins70)\ **Post date:** [June 1, 2020, 7:07pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/38 "2020-06-01T19:07:30Z")
I missed that. Very cool. ---
**Author:** ![zaneclaes](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/zaneclaes/32/16801_2.png) [@zaneclaes](https://forums.maslowcnc.com/u/zaneclaes)\ **Post date:** [June 1, 2020, 7:09pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/39 "2020-06-01T19:09:01Z")
I’m still mostly inferring and speculating, but it looks possible. I’ll start tagging stuff and trying to create some meta-structure (Table of Contents)? ---
**Author:** ![madgrizzle](https://yyz1.discourse-cdn.com/flex031/user_avatar/forums.maslowcnc.com/madgrizzle/32/1372_2.png) [@madgrizzle](https://forums.maslowcnc.com/u/madgrizzle)\ **Post date:** [June 1, 2020, 7:11pm UTC](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537/40 "2020-06-01T19:11:10Z")
> [@zaneclaes](#): > > Anyways, my recommendation would be to use absolute paths in the docs and github, and then use a CI build script to turn them into relative paths during the deployment process. Shouldn’t be hard. You are correct that the relative paths were used so the same files could be used for both github pages and off-line help in webcontrol. If someone can figure out how to use absolute paths and change them so it works in off-line help, I’m all for it. Beyond me though 🙂 [Previous page](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537.md?page=1) [Next page](https://forums.maslowcnc.com/t/documenting-maslow-what-am-i-missing/13537.md?page=3)