Slashdot Mirror


The Analysis of Workflow Analysis?

ziploclogic asks: "Much of my days are taken up performing workflow analysis for courts. For the past few years I have worked for a company implementing their off-the-shelf Integrated Court Management system. While our products are among the best in the industry, I find it difficult to keep my analysis notes organized. The judicial process can vary greatly from state to state as well as from county to county. As to be expected, not one court has been a 100% match to our software. This leads to hours of spec writing for programming changes that must be derived from my notes. Keeping my information organized so that I can prepare said specifications and training plans prove to be a nightmare at times. I have tried one solution that seems to work well for my humble web design company where I send myself gMails with specific keywords in the subject line. This provides for sorting and [later] message retrieval. However, I can leave a court with notebooks [plural] full of workflow analysis notes that I have to decipher in the evenings. I would be interested to learn how others keep their analysis notes organized, especially when working with multiple clients and with multiple [individuals] departments within those clients. Thanks!"

24 comments

  1. An outliner can be your friend by treerex · · Score: 2, Informative

    I find that keeping outlines really helps. If I am using my TiBook then this is usually done in OmniOutliner, though I'm not averse to using Outline Mode in Emacs if I need to share these with others not using Mac OS X. For me being able to categorize my ideas in a hierarchical manner is a Good Thing. In times long gone I used to use Symantec's "MORE II", then UserLand's Frontier... outlines have been a consistent part of my design process.

    You can also find good outliners for Palmtops as well, though it has been years since I installed one and I cannot remember the name of the one I used.

  2. I hate to be obvious, but it has to be said. by daviddennis · · Score: 2, Interesting

    Get a laptop and create a folder for each court.

    Take notes using your computer and save them into the appropriate folder. That eliminates the "scrawl" problem.

    If you're going to visit the court many times, include the date in your file name.

    If you have the need to do a lot of diagrams, this is one instance where a tablet PC or equivalent might be useful. I normally don't like them, but I'm the type of guy who can't read what he's scribbled five minutes after doing the scribbling.

    Hope that helps.

    D

    1. Re:I hate to be obvious, but it has to be said. by ziploclogic · · Score: 1

      There lies the rub - judges et al court staff are not very receptive to my bringing a laptop into our gap analysis sessions. I thought I would try recording my conversations, but found that to be even more difficult.

      So, I've reverted to pad and paper.

      Long story made short:

      One court wanted to go paperless ...even found nifty little LCD's about the size of letter sized paper so that judge could view the docket electronically.

      What I thought was a good solution was, "...an insulting presumption." Judges and tech just don't mix. Maybe the next generation ...

    2. Re:I hate to be obvious, but it has to be said. by Marxist+Hacker+42 · · Score: 1

      I hate to say it, but due to this, most of the methods slashdot is likely to come up with, won't work.

      Having said that, here's my idea:
      1. Create a "blue dots" grid page with an inkjet printer- print out several hundred of these.
      2. At the top of each page- connect the dots with BLACK ink to form a date-time stamp. Write your notes in block printing in black, something that an OCR will recognize, using the blue dots as a guide.
      3. Ship your notes to some low-paid college co-op at the home office for scanning into some common format.
      4. In that common format, have one of your programmers do a "remove blue dots" algorithim", saving out the new graphic.
      5. Run your graphics through a cheap OCR to turn them into text files- and write a quicky little script to move those text files by court-time-date code into sorted folders.

      Anything you can do yourself, can be automated.

      --
      SJW: a person who perceives an injustice, and while correcting it, commits a greater injustice.
  3. Not sure if this will help, just some ideas. by rusty0101 · · Score: 2, Informative

    Most of the MS Office tools allow you to save meta informaiton in the ile Properties dialog. It would be nice if this could be automatically filled in based upon the content of the file, but even then you would have to tidy it up.

    Obviously there are a few desktop search tools available to use for keeping track of this information.

    If you are using Oo.o instead of MSOfice, you should find the same capabilities for saving meta information.

    Another option is to set up a 'keyword' field within documents that you are creating in ordinary text editors. Or set up a template that you use for each applicaiton with fields specifically for various meta information.

    Some others will point out that you should be using some xml to keep track of this. No argument, just haven't used it so can't advocate it.

    You may also want to create an index.html file in each directory you keep specific customer files in, where you document the keywords that are appropriate for that customer. Obviously those keywords should appear somewhere in the content files for those customers as well, otherwise it will be of little help.

    I believe that Google sells an Intranet server that you can use to index your internal documents and internal users only would have access to those documents.

    I am reasonably sure that there are other search tools available, WAIS, plugins for ZOPE, etc. that may help you as well.

    The worst part of keeping track of documents is that somewhere along the line someone is going to forget about updating the kewords in a file as it is copied into a new directory for a different customer. For some time after that, the indexes will bring up the wrong file with a keyword search. This will ultimately be fixed when someone finds that file while looking for something else, and realizes what needs to be fixed, and corrects it for you. Then you have to wait for the document to be re-indexed. Versioning will probably create a few problems with that as well.

    Good luck.

    -Rusty

    --
    You never know...
  4. tablet pc and onenote by eagl · · Score: 1

    Try a lightweight tablet pc and microsoft onenote. Add on google's search utility and you'd have it all.

    1. Re:tablet pc and onenote by ub3r · · Score: 0

      i second onenote. I use it at school and it works great!

  5. I use Treepad by rhild · · Score: 3, Interesting

    Check out Treepad.

    You make a tree in the left-hand pane to orgranize the contents in the right-hand pane. The contents can be text you type or paste in, links to files, links to other nodes in the tree, Web links, etc.

    The contents are also searchable so you can find things that cut across the hierarchy you've created. To make your notes available to others, there is a free viewer you can give to people, or you can also export to a website. The exported website includes a javascript tree so it can be navigated the same as the program.

    There is s free version for both Windows and Linux that may do everything you need. I use the 'Business' edition that has more features and was less than $50.

  6. What about a notebook and a case system? by angel'o'sphere · · Score: 1

    Sorry, but I wonder that such a question wents through the submission process ...

    Are you an educated analyst? I wonder how you do your analysis? I mean, you only make "verbal notes" in "text files"?

    What about doing activity diagrams (or flowcharts)? With every activity having an entry condition (precondition in UML) and a goal/result (postcondition in UML)?

    You would use a CASE system for that like "Enterprise Architect" (googel for it, its about $200 and beats tools like Rational Rose by far). Depending on how you like to run it, you can have a central database at your company and a replica on your notebook. Either for every customer you make a individual project, or you have one single big project for your companies product and make subfolders for each customer inside of it.

    If you don't use a CASE system (or something similar but more specialized to your needs) you are wasting your time.

    angel'o'sphere

    --
    Cost free eBook I read (by iBook/Kobo/Amazon/ObookO/Gutenberg etc.): "The Green Odyssey" by Philip Jose Farmer.
    1. Re:What about a notebook and a case system? by thedude · · Score: 4, Interesting

      We don't know he doesn't use a CASE system. The OP mentioned that his process is:
      - go to client site
      - lern workflow, take notes on it
      - at end of day, go back to hotel and push things into a format for developers (which may or may be CASE/ UML)

      The OP, I think, is really asking something along the lines of "I get tons of info thrown at me by non technical people and need to feed it into some other system to make my programmers happy. Who knows a way of accepting tons of semi-structured, possibly random, and always interrelated data so it can be rearragned and cut up into bite size pieces for some other formalized system without making my eyes bleed?"

      I think the two best suggestions here have been:

      - Wiki (perhaps not only for you, but for the end client as well, so they can see exactly what you're taking back to your programmers and fix mistakes and add details before it goes out)

      - Treenode.. never heard of it, but sounds useful.

      One thing that has not come up yet is what you do with your client before you show up at their site. If you're getting *that* much info per-client I betcha that you could come up with a standardized set of questions for them to answer before you even step on a plane. That should reduce your onsite workload and allow you to better grasp their workflow while onsite.

      Maybe you already do this...

    2. Re:What about a notebook and a case system? by ziploclogic · · Score: 1

      I really like the idea of using a wiki to make the analysis available to both the clients and the programmers. We use a homegrown CASE tool which - leaves a lot to be desired. The biggest problem with our market are the vast differences in work flows between clients. Trying to think of the right questions when taking into consideration local laws proves to be a huge task. I was surprised to discover that a practice in one state regarding criminal procedure could actually be unlawful in another state. Then, there is always the issue regarding law interpretation. Different counties within a given state can vary greatly their interpretation of state laws. These items, coupled with non-technical end users and sub-standard county IT staff make for a wonderful challenge. Thanks for your insight.

    3. Re:What about a notebook and a case system? by crmartin · · Score: 3, Interesting

      Well, I'm certainly an "educated analyst" going back to the days when "GOTO considered harmful" was the cutting edge and from the question I infer with near-100 percent certainty that you're not one. You may be educated, but you've certainly never had to perform an actual meet people in their offices and ask questions analysis task.

      You don't develop preconditions, use CASE tools, or define formal workflows in those sessions; you do that after days or weeks of asking questios, accumulating data, and making vague sketches on whiteboards. Before you can do a brilliant analysis, you've got to know something to be brilliant about.

      Now, having disposed of that, I'd say that you may not be running into a computer tools problem as much as you're running into an intellectual tools problem. Personally, I find the linear notes on a page model to be badly bandwidth-limited; for that kind of analysis, I like to use a big drawing pad (like this one, except Office Max sells one with half-inch quadrille I like better, but it's not on their web site for some reason) and many colors of pen and highlighter.

      I use them to accumulate a series of "mind maps" (see http://www.google.com/search?complete=1&hl=en&q=mi nd+mapping&btnG=Google+Search for some examples) to build up a picture of the information.

      Label each page on a consistent edge with date and time in a consistent format; AFTER the session is done, write some keywords on an orthogonal edge of the paper to remind yourself what the session told you.

    4. Re:What about a notebook and a case system? by angel'o'sphere · · Score: 1

      Hu ho ...

      So I should not have dare to ask wether he is an educated analyst :D

      so this post is rather insightful: http://ask.slashdot.org/comments.pl?sid=132992&cid =11126196 because he "translated" my wondering by reformulating the original question. Which makes sense (to me) now.

      While your post is rather insulting.

      Yes, I'm likely as old as you and do business in computer sciense since far over 20 years. So your 100% certainty failed you.

      And yes: I come with a CASE system to my customer when I ask him questions. And when a CASE system is not appropriated I use an outliner like OmniOutliner.

      However if my customer already is using mind maps or something similar I do not drool about it.

      The big problem of the guy asking is: he has to transform his notes in a way suitable for the programmers.

      So he has to get rid of the transformation step. That means the gathering must be "better" suited for his programmers. If you won't recommend a CASE system than this is your thing ... however hacking around on me is not appropriated.

      Finally:
      You don't develop preconditions, use CASE tools, or define formal workflows in those sessions; you do that after days or weeks of asking questios, accumulating data, and making vague sketches on whiteboards. Before you can do a brilliant analysis, you've got to know something to be brilliant about.


      Sorry for my spelling errors ... but your line has several grammatic errors ... replace YOU with *I* ... because that paragraph obviously is true for YOU, not for ME. YES! I do write preconditions and more or less formal workflows in the first hour ... only the customer does not need to learn the term "precondition" nor the term workflow.

      It sounds like a hugh waste of time if your first "workflow" is delievered weeks after the start of your requirements gathering ... other people already have the first prototype delivered after that time (hint: XP Programming and SCRUM).

      Probably you should learn about "User Stories" used in XP and often in SCRUM or about Use Cases or Scenarios ... and then tell me why gathering a use case in your first session is inappropriate. And after you told me that, give me a clue why gathering some unrelated scenarios are inappropriate!

      And finally after you probably agreed that you do indeed gather "some form of user story or scenario", then please tell me why a precondition for those is not gathered at that stage.

      People interested about SCRUM should probably look at http://www.controlchaos.com/

      Regards,
      angel'o'sphere

      --
      Cost free eBook I read (by iBook/Kobo/Amazon/ObookO/Gutenberg etc.): "The Green Odyssey" by Philip Jose Farmer.
  7. Outliner! by Anonymous Coward · · Score: 0

    Well, my work probably isn't as complicated as yours, but when I'm collecting notes for conceptual modeling and workflow analysis, I'm just collecting reams of textual data with the occasional graphic thrown in. And as I collect this data I need to reorganize it, group it, hammer it into a kind of hierarchy. In fact, most requirements documents seem to be hierarchical in nature, no matter what they are for.

    And for this purpose I can't imagine using anything but an outliner. Specifically, OmniOutliner 3 is what I've been using lately. Not only does it totally rock as an outliner, but you can adjust a few settings, use a couple nice fonts, and get a very nice printed document or PDF out of it.. if you're using OmniOutliner 2 and you haven't tried the beta of 3 DO IT TODAY IT IS AWESOME.

    Okay I don't mean to plug OO3 but if you took away my outliner I wouldn't be able to work! Get a laptop with an outliner and use that to take your notes. Put a copy out on your office or 2nd machine occasionally as well for safekeeping (voice of experience here, heh).

  8. Instiki by GeorgeH · · Score: 3, Interesting

    I use Instiki for my notes and can't live without it. Because it's a Wiki I can create WikiWords that force me to flesh out stuff that I might otherwise overlook. If you have a Mac or Linux the installation is super-simple, not sure how hard it is on Windows.

    --
    Why can't I moderate something "Wrong" or at least "Grossly Misinformed"?
    1. Re:Instiki by angel'o'sphere · · Score: 1

      I use also a wiki: http://snipsnap.org
      Similar to instiki but based on java and not ruby (might be a difference in installing).
      angel'o'sphere

      --
      Cost free eBook I read (by iBook/Kobo/Amazon/ObookO/Gutenberg etc.): "The Green Odyssey" by Philip Jose Farmer.
  9. "The Analysis of Workflow Analysis" by TheSHAD0W · · Score: 1

    Is that related to "The Department of Redundancy Department"?

  10. Not as bad as you think? by OldManAndTheC++ · · Score: 1

    I find it is always the people who are well organized who worry about how well organized they are.

    --
    Soylent Green is peoplicious!
    1. Re:Not as bad as you think? by ziploclogic · · Score: 1

      My wife says the same thing about me. But, I'm always looking for an edge.

  11. Wiki! by bwalling · · Score: 1

    Wikis are great for this. You can organize on the fly, interlink between topics, and edit quickly. I coerced my company into implementing a wiki for all of our stuff, and I have one installed on my laptop for my own notes. We use the same software as Wikipedia - it's free and easy to use.

  12. Workflow Analysis by drissel · · Score: 3, Interesting

    I once had a job trying to routinize software production (don't laugh yet). Every workflow tool we tried !required! that we do things the way the tool wanted them done. Even tho the suppliers claimed that the tool could be customized, when all was said and done, the tool could not be made flexible enough.

    We ended up writing our own tool. (Laugh now) None of the managers were interested; none of the programmers were interested even tho the project promised to handle a lot of routine paperwork automatically.

    This was ten years ago. Are contemporary workflow tools any better?

    Regards,
    Bill

  13. I would help, but.... by nine-times · · Score: 1
    Really, I could suggest any bullsh*t method of analyzing your workflow analysis, but how would you know that I've given you a worthwhile answer?

    Therefore, I think I need to ask the question: how do we analyze our analysis of workflow analysis?

  14. Mac OS X Stickies? by Anonymous Coward · · Score: 0

    Make a sticky to remind yourself to get organized