ElectricMotorcycleForum.com
Makes And Models => Zero Motorcycles Forum | 2013+ => Topic started by: BrianTRice@gmail.com on July 09, 2018, 10:51:25 PM
-
I'm attaching a set of follow-ups to a poll I posted to the Facebook owners group in May (https://www.facebook.com/groups/zmcowners/permalink/1734866776582523/).
Eventually, the wiki will get a "News" section to track this but for now I'll just link to each update in a reply to this thread.
Here's the overview:- Travis Fabel, the site owner, figured out how to separate its hosting from his other web properties, making the site easier to manage. I'd like to help organize a "trust" to manage the site collectively so no individual can take over, it stays public, and we can collect donations to defray costs.
- There's a new "visual" editor (https://www.mediawiki.org/wiki/Editor) which syntax highlights the wiki markup and makes it easier to generate markup. It's not the one I wanted but it was easy to install.
- Mobile layout is now more robust, but the extension does mess with your preferred style for now.
- There are helpers for things like adding standardized warning (https://zeromanual.com/index.php/Template:Warning) messages around dangerous steps. I'll be invoking more of those.
- There's a specific category for quick reference pages (https://zeromanual.com/index.php/Category:Quick_Reference) suitable for loading on your phone.
- There are categories (https://zeromanual.com/index.php/Special:Categories) that help organize procedures.
- I'm pulling all procedures into separate pages (https://zeromanual.com/index.php/Category:Procedure), especially ones worth reading on your phone, optimized for using on your phone. The procedures will still show up in the Service Manual via "transclusion" so they only need updating in one place.
- Generally, the site will shift to a more "bottom-up" / "inverted" writing structure, with small pages being the norm, and huge "books" like the Service Manual will shift gradually to being compositions of smaller articles.
- I added a bunch of classic texts I learned from in the Navy to the electrical skills (https://zeromanual.com/index.php/Skills#Electrical) section. They're free via the Internet Archive.
-
I currently don't seem to be able to save my Appearance Preferences for the Unofficial Manual back to anything but the default Vector, which is difficult for me to read. I also can't read most of the post above, but do have an emailed copy so I know the contents. Undoubtedly fallout from the transition?
-
Heres his post without the color tags so you can read it: (its also a show of how WISIWYG doesnt always work as intended)
I'm attaching a set of follow-ups to a poll I posted to the Facebook owners group in May (https://www.facebook.com/groups/zmcowners/permalink/1734866776582523/).
Eventually, the wiki will get a "News" section to track this but for now I'll just link to each update in a reply to this thread.
Here's the overview:- Travis Fabel, the site owner, figured out how to separate its hosting from his other web properties, making the site easier to manage. I'd like to help organize a "trust" to manage the site collectively so no individual can take over, it stays public, and we can collect donations to defray costs.
- There's a new "visual" editor (https://www.mediawiki.org/wiki/Editor) which syntax highlights the wiki markup and makes it easier to generate markup. It's not the one I wanted but it was easy to install.
- Mobile layout is now more robust, but the extension does mess with your preferred style for now.
- There are helpers for things like adding standardized warning (https://zeromanual.com/index.php/Template:Warning) messages around dangerous steps. I'll be invoking more of those.
- There's a specific category for quick reference pages (https://zeromanual.com/index.php/Category:Quick_Reference) suitable for loading on your phone.
- There are categories (https://zeromanual.com/index.php/Special:Categories) that help organize procedures.
- I'm pulling all procedures into separate pages (https://zeromanual.com/index.php/Category:Procedure), especially ones worth reading on your phone, optimized for using on your phone. The procedures will still show up in the Service Manual via "transclusion" so they only need updating in one place.
- Generally, the site will shift to a more "bottom-up" / "inverted" writing structure, with small pages being the norm, and huge "books" like the Service Manual will shift gradually to being compositions of smaller articles.
- I added a bunch of classic texts I learned from in the Navy to the electrical skills (https://zeromanual.com/index.php/Skills#Electrical) section. They're free via the Internet Archive.
-
Brian,
Can you include a section for fixing a stuck contactor? It was killing me until I saw this post:
http://electricmotorcycleforum.com/boards/index.php?topic=7963.0
I think it could help many people in the future.
Steven
-
I currently don't seem to be able to save my Appearance Preferences for the Unofficial Manual back to anything but the default Vector, which is difficult for me to read. I also can't read most of the post above, but do have an emailed copy so I know the contents. Undoubtedly fallout from the transition?
I dont believe I installed any appearance options besides the default, a modified version of Vector I made.
Brian is putting some mods in to allow for mobile views along with the desktop... I think we can offer a few brighter options now. Honestly I never change any sites from their default so I didnt think much about it.
-
Dang. Sorry about the format. I’ll try to fix it soon. The forum editor has some crazy bugs when I do anything slightly fancy.
EDIT: it's fixed. But I don't think this rules out WYSIWYG editors - Wikipedia's is extremely well tested compared to this crappy forum software, and has good fallbacks like the editor we're using for the zero manual right now.
-
Brian,
Can you include a section for fixing a stuck contactor? It was killing me until I saw this post:
http://electricmotorcycleforum.com/boards/index.php?topic=7963.0
I think it could help many people in the future.
Steven
One of the great things about it being a wiki is anyone, including yourself, can add information that could be useful to others.
-
There’s definitely a preference saving bug which I can’t trace down yet since I’m only using file sync methods and can’t log in to the server yet.
-
Okay. I can "preview" the other appearances but clicking on save reverts to the default.
-
This thread is not about specific wiki content requests. This is about site strategy.
That said, I’ll add requests to my queue.
Bear in mind that how it gets integrated may not match how you think about it because I have to make sure that explanations can be found across a variety of perspectives. That’s one reason for this set of changes.
-
I'm going to try debugging the preference-saving issue by iterating through all the new extensions, turning them off until it works. Thankfully, I have a shortlist of extensions that do use preferences, which hopefully will save some time.
-
Brian,
Can you include a section for fixing a stuck contactor? It was killing me until I saw this post:
http://electricmotorcycleforum.com/boards/index.php?topic=7963.0
I think it could help many people in the future.
Steven
One of the great things about it being a wiki is anyone, including yourself, can add information that could be useful to others.
I didn’t realize permissions were there for us to all assist. I created an account, but it looks like everything so far has been contributed by Brian.
-
I didn’t realize permissions were there for us to all assist. I created an account, but it looks like everything so far has been contributed by Brian.
Yes, I definitely took over the content and editorial effort and have set the tone for it. I have a background with technical writing and a disciplined set of skills around it around my two decades combined of nuclear technician and software development experience.
I need to be clearer that contributions can be messy in terms of wording as long as I can clean it up. It's easier for me to clean up someone's work than to do the initial entry where I'm not the direct witness and have to read online posts to interpret.
You can always use your user talk page as a scratch space when you don't know where to put something.
-
FYI the preferences bug does not have a clear cause yet despite me disabling a bunch of plugins and turning on many debug flags.
I’m still investigating and will update once resolved.
-
FYI the preferences bug does not have a clear cause yet despite me disabling a bunch of plugins and turning on many debug flags.
I’m still investigating and will update once resolved.
I finally figured out how to see the errors that were blocking preference-saving. The offending extension is now disabled so you can set your preferred theme and other settings freely.
Sorry about the trouble! Plenty of content has been churned through lately, at least.
-
My favorite two new pages:
- For the warning flashes on the dash: https://zeromanual.com/index.php/System_Warning_Sequences
- For error codes: https://zeromanual.com/index.php/Error_Codes
Each one supports deep linking to each code:
- Precharge Failure sequence: https://zeromanual.com/index.php/System_Warning_Sequences#1-4
- Precharge Failure error code: https://zeromanual.com/index.php/Error_Codes#27
-
Great job with the manuals Brian. I know I speak for everyone in saying how much we appreciate it.
-
It is a lifesaver! Much love for the hard work on the manual man.
-
Takes you a lot of time, effort and knowledge keeping up-to-date and filtering all the info and non-info.
Hope you stay anthousiast at it.
How much you think you cofered there is to now about Zero stuff? Allready > 70% or still thinking: a lot is still uncovered..?
Good job!!
-
The more I learn, the more I realize is not covered.
I have no exposure to Zero dealership network information or diagrams. I’m building it up from corroborated hearsay or confirmable assertions.
This is why it’s weakest in the area of troubleshooting, because it’s difficult to troubleshoot an incompletely observable or documented set of systems.
There is no way that it’s comprehensive. The best one can say is that it has something to say about everything we’ve thought of and had time to try writing about.
Consider this The Hitchhiker’s Guide to Zero Motorcycles.
You have to apply some judgement and self-assessment with anything you read because it may not be written for your skill level, or just hasn’t incorporated enough background information to make full assessments.
-
Consider this The Hitchhiker’s Guide to Zero Motorcycles.
I like this idea. Maybe I'll put the words 'DON'T PANIC' in large, friendly letters on the footer of the pages.
Partly because the wiki "looked insanely complicated" to operate, and partly to keep internet travellers from panicking.
:p
-
Yeah, the Hitchhiker's Guide aesthetic still seems like a good idea.
FYI I've finally worked out how to configure Apache so that wiki URLs actually indicate that you're on a wiki:
Main page: https://zeromanual.com/wiki/Main_Page
New troubleshooting page: https://zeromanual.com/wiki/Troubleshooting
Existing links with "index.php" in the path get redirected to the new form, so everything is backwards-compatible. I expect that it will take about a month or so for search engines to update their site indexes.
My motivations are: (1) it's easier on the eyes, and (2) people seem very unclear on this being a wiki.
I want the fact that it's a wiki constantly reinforced so that: (1) it's taken less seriously, and not confused with Zero (this happens! even with the distinctive logo) and (2) more people feel encouraged to contribute.
-
Added photo of oscilloscope screen from Sevcon motor controller terminal M3 from 2017 SR to the Controller (https://zeromanual.com/wiki/Unofficial_Service_Manual#Controller) section.
-
I followed https://zeromanual.com/wiki/How_to_build_a_cable_to_access_the_MBB (https://zeromanual.com/wiki/How_to_build_a_cable_to_access_the_MBB).
It works with a 3V3 TTL serial converter, for instance https://uk.rs-online.com/web/p/interface-development-kits/7676200/ (https://uk.rs-online.com/web/p/interface-development-kits/7676200/)
Mine's baudrate is at 9600N1 instead of the 38400N1 from the manual.
Do we need a table of baud rates? Not sure how to format that.