Results 1 to 3 of 3

Thread: documentation and information distribution

  1. #1
    just me duncan drennan's Avatar
    Join Date
    Jun 2006
    Location
    Cape Town
    Posts
    2,642
    Thanks
    119
    Thanked 94 Times in 77 Posts

    documentation and information distribution

    I was wondering what solutions people have to the problem of information sharing and documentation.

    Let's say there is a product and there is one giant document that describes the product in its entirety. So that means it describes what is does, how it does it, what the internal functions are, what the end-user functions are etc. etc. etc.

    Now there would be two aspects to this document, one being compiling all the information, and the other dissemintating the information to the people that need it.

    Clearly there are only certain parts of that document that are useful to certain people, for example, the end-user doesn't care how it works, just how to use it to do what they want. On the other hand the software developer only cares about the interface between the hardward and the software, he doesn't care about all the hardware's internal interfacing...and so forth

    Everyone with me still? I hope so....

    My natural tendancy would be to break the big giant document into a number of smaller documents that are aimed at the relevant people (e.g. user manual, programming interface, hardware description etc.). I'm sure others would have another approach.

    Certain people would also need access to all the information (in some form or the other), for example the person writing the manual may need to know everything to compile the information into a user friendly document.

    So basically there is one big repository of information and a bunch of subsets of this.

    How do you go about handling information of this sort? Are there any programs, collaboration platforms or anything like that that you use to share information effectively?

    What would your approach be?
    [SIGPIC]Engineer Simplicity[/SIGPIC]
    Turn ideas into products | The Art of Engineering blog

  2. #2
    Site Caretaker Dave A's Avatar
    Join Date
    May 2006
    Location
    Durban, South Africa
    Posts
    22,741
    Thanks
    3,322
    Thanked 2,688 Times in 2,265 Posts
    Blog Entries
    12
    The full version of MS Office allows for collaboration. A Wiki might also be a solution. Perhaps a CMS?

    It's an issue that is on my horison but I haven't looked at it too closely as yet. We solve it by putting a version in shared documents and then archiving copies along the way. But it is not a particularly secure way of going about it if the are people who will have acces to all when you only really want them to see part.

    I'd be interested in a solution too if anyone's got one.

  3. #3
    just me duncan drennan's Avatar
    Join Date
    Jun 2006
    Location
    Cape Town
    Posts
    2,642
    Thanks
    119
    Thanked 94 Times in 77 Posts
    Pity there hasn't been much response to this so far...

    My problem is more one of figuring out what the best way of thinking is. Once I've got that I'll try to fit a tool to it as best I can.

    One of my issues is that I hate repetition for a number of reasons, mainly that it is a waste of time (inefficient) and that every time something is repeated there is room for error (especially with documentation).

    So, conceptually, what are your ways of approaching this type of thing?
    [SIGPIC]Engineer Simplicity[/SIGPIC]
    Turn ideas into products | The Art of Engineering blog

Tags for this Thread

Did you like this article? Share it with your favourite social network.

Did you like this article? Share it with your favourite social network.

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •