We are reworking our Code Information Sheet(s) and I'm not sure what the best approach to it is, and more precisely some of the pros & cons of different approaches. I've seen these sheets done as all text on a page, text in drafting views, generic annotations with some fill-in the blanks, fake schedules (key schedules / Ideate Sticky, etc), and a hodgepodge of all of the above.
Frequently these have a lot of copy/paste from the code, which I am especially against since there is far too much probability of someone not updating the text to reflect a state or local variation, even if the actual review was done correctly.
Anyhow - I'm curious what others are doing and if there are any caveats or major issues encounted with any of these methods, or if I am just overlooking something altogether. :beer::beer:
- I don't like the text on page as it leaves way too much room for user error, both in formatting and deleting things that should exist. Yes, I shouldn't have to worry about it but I'm a curmudgeon.
- Text in drafting views has the same issues, although somewhat reduced since the individual segments would be separate views.
Frequently these have a lot of copy/paste from the code, which I am especially against since there is far too much probability of someone not updating the text to reflect a state or local variation, even if the actual review was done correctly.
- In theory generic annotations would be a good option; it would be easy to create objects based the various code sections, but there is some layout flexibility that is lost because they are a defined size that is difficult to change, although that isn't much different than the drafting view approach. This could result in dozens of families though...
- Fake schedules are OK for some pieces, not really opposed as long as the traps mentioned above are avoided.
Anyhow - I'm curious what others are doing and if there are any caveats or major issues encounted with any of these methods, or if I am just overlooking something altogether. :beer::beer:
Comment