Will the design plans be documented?

[meserret]

I am working in a newspaper and we newly included our internet site to the scope of our quality system. We accepted that, if any changes are done at our internet site then it requires a design process. The changes sometimes are decided by internet editor only. Sometimes advertisement department takes role in this decision. So, the planning sometimes is very complicated but sometimes it is very very simple as "the page will be completed by tuesday..". So, i want to learn do we have to document our desing plans or is it adequate only to say that it was made.

I hope i could explain the problem sufficiently.

Thanks for your help.

------------------
Meserret

 

[Marc]

The short answer is if you do not document it it didn't happen.

That said, you shold as a minimum map out the basics. Think of it in terms of purchasing something. If you only want to buy a $10 tool, there is one 'approval' path. You want to buy a $1,300 machine there is probably another approval path. You want to spend $193,000 to upgrade a department there will be another approval path.

Do the same. At what 'level' does another level of management have to approve. But keep it simple. Keep details to a minimum - think scope. Daily update? Breaking news update? Entire site is revamped including structurally? Weekend inclusion?

You should be able to flow chart the base system fairly easily once you get to thinking about who does what and when.

As far as documnenting the changes themselves, yup - but your site editor (Dreamweaver or {god forbid} GoLive or whatever) should allow for notes and such for changes. Document 'minor' changes there.

Use your system documentation to define what is a 'significant' change and what is not - assuming 'significant' changes will have to be documented more thoroughly than 'minor adjustments' or such.

Yes - you have to document your design system and you have to keep records of design changes.

[This message has been edited by Marc Smith (edited 12 February 2001).]

 

[meserret]

Thank you for your answer and please excuse me for my lack of understanding. So, if I map the entire design process and write down it as a work instruction which is telling who is responsible from what and telling all the stages; is it enough as a documentation? We want our internet department to fill in some forms showing the responsibles and stages and they find these forms nonsense. They say, everything they do can be seen on the screen. Who designed the site, which pictures are used and so on. They are asking us to reduce (really: cancel) these forms.Is it a necessity to write down on some sort of forms who will supply the inputs and when; who will verify the desing and when; who will validate the design and when?

Thenk you for your patience and help.

------------------
Meserret

 

[Marc]

As I said, you have to define the system - I recommend flow charts.

Yes - they can see it on-screen and such. They may be tracking changes as I said above - the program they are using (for example I use DreamWeaver) may allow them to track changes. But what is part of your process and what is really a design change?

This does not remove the neccessity to define the basic system and to define responsibilities, by the way.

As far as forms being filled out goes, you have to determine at what threshold a form will be required. If they want to change a footer, who is required to authorize it? You say you're a newspaper -- a late breaking story comes in. Who can authorize it to be published on the site? Surely not just anyone. Do you need a form at this level? How is the authorization communicated? Does an editor call the layout person and say something like "...Late breaker to post. File is ready - file name is 1234-detmd-23m-wwet.doc and it's on the Z drive in the 'late_breaker directory. Put it on page 1 under our 'Late Breakers' sub-heading." Or is this communicated by e-mail? Does this need to be documented? It depends upon how you have your system set up. That's part of your process and less of a design issue, in my opinion.

Let's take another example. Let's say the layout person wants to make a major change to the site layout. S/he wants to move the 'Late Breakers' links to another page - taking it off the main page. And s/he wants to eliminate 30% of the advertising space because s/he believes the advertisements are distracting from the content and are thus driving 'customers' away. Who can approve these changes? Do you feel written evidence is necessary? Do you need a form or will a log do? These are just a few questions you have to ask yourself about what you do now.

1. Never require paperwork without a good reason.

2. Make sure you have a well defined line distinguishing what is, in fact, a design change as opposed to part of the process (reporting the news or whatever).

[This message has been edited by Marc Smith (edited 12 February 2001).]