3D Robotics

Feedback on new manuals

We're moving to a new documentation platform and this is your opportunity to give us feedback and help. There has been a huge amount of work going on behind the scenes on these over the past three months, including the 30 volunteers working within the Documentation User Group. It's now time to include the full community.

You can see a glimpse of the team's work in the betas of the new ArduPlaneArduCopter and ArduRover sites. Click on the "Instructions" tab to see what the new manuals will look like. 

Right now most of the work has been in creating new graphics and design elements to make the manuals easier to read and use, with some work on simplifying and updating the content. But because they're based on a Wiki-plugin for WordPress, it's also a much more powerful and flexible collaboration environment than the current Google Code wiki for community participation, and we can now take this opportunity to update and improve every page of the manual. 

Just a reminder that these sites are still in beta, and we won't be steering users to them until the documentation team has had an opportunity to scrub every page. We'll continue to maintain the Google Code wikis for legacy purposes, but the new sites are designed to reflect the model we'll be moving to in the future. 

Please give us feedback in this thread. If you'd like to participate, please join the Documentation User Group linked above. 

You need to be a member of diydrones2 to add comments!

Join diydrones2

Email me when people reply –

Replies

  • Hazy,
    老板说些什么
  • The new site looks wonderful. I'm curious about whether we can add multiple language instructions in this site?

  • I have an APM 2.5 in the mail headed to me at the moment. And I'm doing some more reading before it gets here and there are two things I haven't been able to find that aren't necessarily vital but would be nice:

    1) A photo of a complete APM 2.5 with GPS and Telemetry options that is hooked up to a receiver and servos. I'd just like to see everything plugged in the way it's supposed to work and laid out before it's mounted in a plane. Diagrams and models of things are nice, but a finished working setup is nice to see also.

    2) Some example telemetry output files. I will probably use the ArduPlane software for most things, but I also want to make my own codes to analyze flight data. It would be nice to see a few example files that I could download and look through just to know what I'm getting into ahead of time.

  • Hi

    The sites looks nice but i have two inputs.

    1. If you use wordpress i would like to see a google translate plugin. I know most of the translations are bad but better bad than nothing ;-)

    2. For newbies i think the structure from the instructions is a little bit overkill. It must be simple as possible (step by step) and for beginners only with the ground informations that they need.

    I think it must be splitet in two parts ex: (ground settings / Tweaking )

    I know its really difficult to find the right structure :-)

    Greetings

    Tino

  • Leveraging all of the community wisdom to create the Wiki is exactly what was needed. Thank you.

  • Hi,

    The links on the Arduplane downloads page points to arducopter downloads.

    farmertom

  • After a quick review - it would seem that APM 1.0 and 2.0 hardware setup should and could be included.

    Those are not moving targets and already mostly documented.

    Also in the safety section I see nothing about "Ariel right of way".. meaning that if you see a manned flying vehicle in the air  at a low altitude then you should be heading to the ground ASAP. 

    This is very important and should be one of the 1st things in the safety guide. Human safety is far more important than any of your non-human hardware. To underline the point... if you need to crash to get out of the way that *IS* what you do. If not you risk ruining the hobby for everyone.

    Also an explanation of what an autopilot does and what that means to you the reader.

    Simply put an auto pilot relies on environmental conditions to perform as desired.

    GPS, Magnometers  and other sensors can get false positives or fail in flight, this is why its extremely important to rely on the human factor as the ultimate backup. These are not remote control devices that fly based on mechanical input only. They use logic and sensors to determine their orientation heading and speed from sensors which can be prone to being affected by other environmental issues. Most people think "Well GPS is reliable it works great in my car" w/o appreciation for the complexities of the GPS (or any other sensor).

    For that very reason GEO fence is nice, but certainly not a completely reliable fail-safe.

  • I haven't take a deep look into it, but seems great. Good job!!

  • Distributor

    One quick note, maybe add these links on the old "current" wiki landing page with a blurb telling people that it is still work in progress... I get quite a few emails per day on what version of the "manual" to use... :) 

    Thanks, good work so far, can only get better. 

    Dany

  • Hi there

    If you are working on new manuals, are you also including new frequencies?

    If so, I found the official frequency plan for Switzerland as PDF. There are some differences, ex the 433mhz Band you can use 1mW on some frequencies, but up to 2.5W on others (depending on duty cycle).

    http://www.bakom.admin.ch/themen/frequenzen/00652/00653/index.html?...

    source:

    http://www.bakom.admin.ch/themen/frequenzen/00652/00653/index.html?...

This reply was deleted.

Activity

Hank Deucker left a comment on PIXHAWK
"Tomorrow, I am thinking about the wording at the moment."
3 hours ago
DIY Drones via Twitter
Welcome to the new DIY Drones design!. You may have noticed that DIY Drones looks a little different today. That's… https://t.co/cg2EmeDGMQ
17 hours ago
DIY Drones via Twitter
New! Online Training on Drones for Disaster Response https://t.co/brqRuujjY2
Tuesday
DIY Robocars via Twitter
https://t.co/8EMCvYW6oz
Tuesday
DIY Robocars via Twitter
RT @OttawaAVGroup: We are going to try something new this week. We will be having a drop-in style meeting Wednesday @ 7-9pm EST. Pop in and…
Monday
DIY Robocars via Twitter
RT @tawnkramer: Thanks Everyone for another fun virtual race! Amazing Ai racers competing head-to-head, Virtual Makers Fair event. Catch us…
Sunday
DIY Robocars via Twitter
RT @make: Find out the latest from @diyrobocars at 10am PT from @chr1sa of @3DRobotics on Virtually Make Faire! #makerfaire #maketogether #…
Saturday
DIY Robocars via Twitter
RT @Heavy02011: Join us Saturday online: Virtual Race League: @DIYRobocars Race #2 - Parking Lot Nerds https://t.co/aJUu4sdutx #Meetup via…
Saturday
DIY Robocars via Twitter
RT @donkey_car: Yay, we are part of the virtual @makerfaire with @diyrobocars. Come see our race or better yet train a model and race with…
May 21
DIY Robocars via Twitter
RT @chr1sa: The @DIYRobocars Virtual AI Race is going to be part of the virtual @makerfaire on Sat! https://t.co/wnMDAboLID
May 20
DIY Robocars via Twitter
RT @tawnkramer: Please join us next week for our second DIYRobocars online race. We will be using a new Mountain Track course! https://t.co…
May 19
DIY Robocars via Twitter
RT @SmallpixelCar: I realized that the size of the cones in @diyrobocars is known. If we can detect the bounding box, which can be done wit…
May 19
DIY Drones via Twitter
RT @chr1sa: Our next @DIYRobocars autonomous car virtual race is this Saturday. Sign up here to compete or just spectate on @Twitch https:/…
May 19
DIY Drones via Twitter
Definitive Guide to Setup Drone Delivery System https://t.co/7ibwcgF24h
May 19
DIY Robocars via Twitter
RT @DAVGtech: The next @diyrobocars virtual robocar race is this Saturday. One of many interesting issues we are taking a stab at is "how c…
May 18
DIY Robocars via Twitter
RT @chr1sa: cc @DIYRobocars @donkey_car https://t.co/ewbyqZ3xC0
May 18
More…