Bugtation No.57
Tuesday, October 28th, 2008Computation “is a succession of” steps. “To” compute “each one is to succeed.”
- Dmitry Vostokov @ DumpAnalysis.org -
Archive for October 28th, 2008
I’m RARE
Tuesday, October 28th, 2008It is not about me. It is the reciprocal counterpart to Five golden rules of troubleshooting. Whereas the former are for artefact submitters, internal and external customers of memory dump analysts and complex trace readers, I‘m RARE are rules for writing analysis reports with easy to remember mnemonic:
I‘m RARE - Iridium Rules of Analysis Report Excellence
Note about Iridium metal from Wikipedia: “It is one of the rarest elements in the Earth’s crust, with annual production and consumption of only three tonnes.”
Here is the draft number 5 of them (subject to change in the forthcoming weeks):
-
Use a template.
-
Structure a report according to audience technical level and organizational processes.
-
Use checklists not only for commands and tools but also for things to avoid in reports and things to encourage.
-
Put all relevant data for later search and for other engineers to reproduce the analysis.
-
Provide appropriate explanations and narrative in the cases where analysis is inconclusive.
This also needs to be integrated with PARTS methodology.
- Dmitry Vostokov @ DumpAnalysis.org -