Skip to Content

I was waiting in the lobby of a hospital. One of the things I noticed was there was as lot of posters on how to work on documentation. It made me think that documentation is a universal issue that every profession has or at least most profession experiences.

I was thinking of areas where they do not document. I was thinking of childcare or housepainters. I guess that in the first instance it would make sense to document the child’s progress. The house painter could probably document what he has done, in order to avoid other problems in a later stage and easy paint the same color for the client again.

Sorry the poster was in Danish, but I’ll try to give must best summery of them.

One of the things I noticed about the posters is that they focus a lot of the process on creating documentation. The first poster present a process that a unit has been thru to learn what and how to make sure the documentation was in order.

image     

The main principle that they are proposing is to du an audit, where a large part of the staff is working together to review the documentation already created. They use a list of 28 questions from the hospital to make sure the documentation is up to the state the hospital requires. Then they implement changes to improve the documentation for later patients.

The other poster wrote about a process for a creating for an entire hospital and how to make sure that everybody know how to document. A part of the process is also the test everybody’s knowledge according to some guidelines. That should also be an idea that we should start to implement.

image     

It claims that documentation is a process that can be improved all the time, and effort needs to be created to work on this.

This is also something that I see as possible in the perspective of SAP documentation. It is not enough just to use the same templates or process that we used 10 years ago. We need to update our knowledge to make sure that we use the best procedures.

I’ll be talking about documentation in SAP PI at SAP Teched in Las Vegas. I hope that my presentation there will inspire you go learn more about your own documentation process and make sure you create better documentation.

I have also created a survey of how people use SAP PI for documentation. The survey is free.

To report this post you need to login first.

2 Comments

You must be Logged on to comment or reply to a post.

  1. Bhavesh Kantilal
    While documenting PI Interfaces for Integration Directory configuration I have always been a fan of using more pictures than words.

    I have always wondered How do documenting things such as Receiver Determination, etc in a word document helps especially when the values tend to change in every environment. Classical Process flow diagrams, Flowcharts, etc do more wonders for me when reading / understanding a interface than tabulation.

    Its the same everywhere, pictures speak and I would love to have a spec that has more images with logic / process and algorithms but unfortunately its not the case too often these days.

    I wish I were at Vegas for your session, but I do think it would be a great session to attend. Looking forward to your article / thoughts after the presentation.

    All the best,
    Bhavesh

    (0) 

Leave a Reply