Greetings, all,
I've just put the latest build onto the public server, which contains three new chapters
of the Developer Guide:
<http://hackystat.ics.hawaii.edu/hackystat/docbook/pt03.html>
There's a substantial amount of new material in there, and hopefully it will be of
particular use to folks who are working on new modules. If anyone feels like taking a
look and sending me any comments or corrections, I'd be happy to get them.
One thing I'm discovering: each chapter I finish reveals at least two additional chapters
that need writing. I've got 9 more chapters on my "urgent list", including:
- How to define a new SDT
- How to define a new Sensor
- How to define a new Analysis
- The low-level sensor data API
- Sensor data abstractions: DailyAnalysis, DailyProjectData, etc.
- The Hackystat Test Framework
- Writing Hackystat Docbook Documentation
- Anatomy of the SensorShell
- Writing Telemetry Reduction Functions
Then there's a bunch more chapters on the "less urgent" list. For example, basically
every hackyApp module should have a documentation chapter associated with it that
explains how to use the associated application and what you should expect to get from it.
I don't intend to write all of these--the hackyApp module developers will have to do that
themselves. :-) (Of course, I need to write the chapter on Writing Hackystat Docbook
Documentation before I can ask that of anyone!)
And that's just the Developer Guide...
It's a marathon, not a sprint, but the good news is that steady progress is occurring.
Let me know what you think.
Cheers,
Philip
