Documentation of Decisions

[CECSpecialistI]

• Do we need written decisions, visual charts, and example code for every decision?
• Is example code in addition to sample output generated by the transform helpful? Is it needed? Who is in charge of maintaining it when decisions change? Crystal cannot commit to maintaining and adjusting high volumes of example output by hand. Is outdated example output something we can live with?
• Case-by-case choice?
• Where should example output be located? What is our plan for its upkeep? Example: $5 example output
• What extent is appropriate for example output? How far removed from the individual decision can the output go before it's too much? Can we strike a balance between "whoa, that's too many triples, I'm lost...where is the example of what we're talking about?" and "hmm, I wish there was more context here"?
• How will we refer to a decision in the mapping spreadsheets? Number or URL? Which column? Attn: Theo & Zhuo, who will be the ones on the receiving end