Is there a group/person working on, or is anyone interested in working on, developers documentation?
I'll start by saying I'm new to this project.
So, as a way of getting familiar with everything, I've been studying both the hardware and software by reading data sheets on all the chips and doing a code review of all the code.
If anyone is working on documentation I'd like to help. Here is an outline of what I'm working on.
1) Block diagram of the hardware communications from chip level.
This should be combined with the schematic and a short / long description of how the electronics function.
2) Wiring diagram and photos of how everything connects.
This might include multiple examples showing a minimum configuration and a full configuration. It should also show some examples of how the system could be expanded.
3) Block diagram of code functions outline.
This is not a users manual. It would not cover normal operation procedures. This would describe the internal workings of the code.
4) Code descriptions and analysis.
How is the system initialized?
How is data collected from the censors?
How are flight controls manipulated?
What are the functions used to maintain level flight?
What happens if the code crashes?
Given the Min/Max values of all inputs, what happens through all values? Any divide by zero problems?
5) Logs and telemetry.
What data is maintained by the system?
What data is transmitted to the ground and how can it be analyzed?