documentation is key.

Web Development

I am in the process of finishing up a project for my consulting company and one of the final things I do before handing over everything to my client is to provide detailed documentation of what I did, how I did it, and how to modify what I created. Why? I feel it is very important to empower my clients by giving them solutions they can maintain or that the very least – make minor but important changes (navigation changes, content changes, etc). After finishing up the documentation tonight, I decided to centralize my documentation for my clients by setting up MediaWiki (my wiki of choice) and then setting up access to different clients. By using a wiki, I can easily maintain the documentation I have done for all my projects (a good reminder of what I did when I need to update/change my code in the future, as well as I can have the clients add personal notes, etc on what they have found to work. I will install and set up the wiki this weekend and then start moving over my documentation from all my current clients so I can get them using the wiki. I hope this works out!
[tags]wiki, MediaWiki[/tags]

2 thoughts on “documentation is key.”

  1. apokalyptik

    Good girl! Helps to be able to charge for it too doesnt it? 😉 😀 MW is great, Out of curiosity how do you plan to manage the ACL’s so that client X cant see client Y’s docs (or even that you have client Y?) Different MW installs, or a very complex set of htaccess rules?

    Cheers
    DK

  2. jenz

    Good question. I was hoping there would be a MW extension to take care of view permissions…this weekend will be my research time.

Leave a Reply

Your email address will not be published.
*
*

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Life Software

Meebo me.

I have been using meebo for some time now on and off and a few days ago I added a “Meebo Me” widget to my resume sidebar to test out and I have to say…it is very cool. I am considering adding the widget to my home page as well as to my blog page, […]

Apple

WWDC From Home

Last year I attended WWDC and loved it. This year I was unable to attend, but I did follow the keynote address and then took a look at the Leopard Sneak Peek and the new Mac Pros. I will be very interested to see how the Mac Pros perform as I am, and always have […]