I tackled the documentation training this week because I feel like I’ve gotten a lot of experience writing documentation this summer and have generally done a lot of documentation writing while at Grinnell. I felt like the training does a good job of showing fellows a baseline standard for documentation, but it might be useful to have more elaboration on the different kinds of documentation and how to effectively create them. I’m not sure the training would benefit from the step-by-step walk through that the other trainings have, it feels like it’s already pretty effective in the current form. I feel like it could also be helpful to include some guidance on writing slightly longer form documentation, as the simple documentation for one or two tasks while it can be helpful, for full-fleshed out digital humanities projects you often need more extensive documentation. I wonder if level up tasks could include drafting an outline for a longer set of documentation or something similar.
Leave a Reply