X Nations - View Single Post - A little non-poll poll about CGI scripts and installation

Panky · 02-24-2003, 10:07 PM

For small, easy applications, create a "wizard". For something that is above beginner/intermediate level, right the complete instructions. So many times I have worked scripts for "advanced" levels and the instructions left key elements out. Don't assume that even the most experienced user/installer will know that this file needs this permission and installed with this particular file in order for it to work for this particular element of the script, for example.

When you visit msg. boards/help forums and you post, "I did everything by the instructions and still will not run." and you receive replies like, "I had the same problem...and they give you the fix." Then they tell you it took them hours or days to figure out the missing link. Write the instructions as if you never wrote the script.

Panky

02-24-2003, 10:07 PM	#6
Panky Panky is the Queen of Mean Moderator Join Date: Nov 2002 Location: Montréal Posts: 4,780 xBucks: 31,707	For small, easy applications, create a "wizard". For something that is above beginner/intermediate level, right the complete instructions. So many times I have worked scripts for "advanced" levels and the instructions left key elements out. Don't assume that even the most experienced user/installer will know that this file needs this permission and installed with this particular file in order for it to work for this particular element of the script, for example. When you visit msg. boards/help forums and you post, "I did everything by the instructions and still will not run." and you receive replies like, "I had the same problem...and they give you the fix." Then they tell you it took them hours or days to figure out the missing link. Write the instructions as if you never wrote the script. Panky