473,320 Members | 1,746 Online
Bytes | Software Development & Data Engineering Community
Post Job

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 473,320 software developers and data experts.

Help!

Fred wants an e-commerce website. He commissions Jo, a freelancer who is a good web
designer and knows a little about programming (from an extremely sub-standard
university), to create the website for him. Jo sets to work creating lots of pretty HTML
pages with calls to as-yet-unwritten PHP scripts mixed in with the HTML and Javascript.
To explain what these scripts are supposed to do, Jo inserts drastically brief comments
into the design pane of Dreamweaver. Of course, they are scattered across various
irrelevant places in the source code. There is no documentation or functional/technical
specs of any kind. Neither would Jo know what these were if one of them wrestled him to
the ground and jumped up and down on him. Jo commissions his friend, Henry the freelance
programmer, to write the PHP.
I've just started work as a freelance programmer. My only source of work (hopefully this
will not last) is my friend Henry. As my first job, he assigns me the PHP coding for
Fred's website (before either of us know what a mess Jo is going to create). I am
formally committed to this, and could not turn it down under the circumstances anyway.
Working with Jo's mess is, of course, impossible. When I explained my difficulties to
Henry (who went to a better university and understands due process), he forwarded my
concerns to Jo. Jo has now sent me the following:

###
Can you be a little more specific about what you want?
My idea is to send you a word document specifying everything a page is supposed to do. I
will also send you a graphic with the pages a customer will go thought to make an order
(typical).
Let me know if this would suffice
###
How can I explain to him the nature and necessity of Functional specs->Design->Code, and
that of clean separation of code (PHP) from data (HTML) ?
Jul 17 '05 #1
4 1822

On 2-Jun-2004, "Khen Chzakuv" <no**@none.com> wrote:
(snip)
Working with Jo's mess is, of course, impossible. When I explained my
difficulties to
Henry (who went to a better university and understands due process), he
forwarded my
concerns to Jo. Jo has now sent me the following:

###
Can you be a little more specific about what you want?
My idea is to send you a word document specifying everything a page is
supposed to do. I
will also send you a graphic with the pages a customer will go thought to
make an order
(typical).
Let me know if this would suffice
###
How can I explain to him the nature and necessity of Functional
specs->Design->Code, and
that of clean separation of code (PHP) from data (HTML) ?


Welcome to the real world. You should be able to work with the documentation
Jo proposes. It's rare in small programming projects, especially web sites,
to have any kind of formal design process. If you want formal specs you will
probably have to create them yourself.

--
Tom Thackrey
www.creative-light.com
tom (at) creative (dash) light (dot) com
do NOT send email to ja*********@willglen.net (it's reserved for spammers)
Jul 17 '05 #2
Tom Thackrey wrote:
Welcome to the real world.
Thank you :-)
You should be able to work with the documentation
Jo proposes.
That's the problem - for practical purposes, he doesn't propose any.
It's rare in small programming projects, especially web sites,
to have any kind of formal design process. If you want formal specs you will
probably have to create them yourself.


I can take that. The biggest problem is handling the mess he's already written.
Jul 17 '05 #3

"Khen Chzakuv" <no**@none.com> wrote in message
news:xn***************@news.actcom.co.il...

<snip>
Can you be a little more specific about what you want?
My idea is to send you a word document specifying everything a page is supposed to do. I will also send you a graphic with the pages a customer will go thought to make an order (typical).
Let me know if this would suffice
###
How can I explain to him the nature and necessity of Functional specs->Design->Code, and that of clean separation of code (PHP) from data (HTML) ?


And your problem is?? ;)

Yes, I've been there many times. And it really has little to do with the
caliber of Univ. It more has to do with thought process, training and "where
they are coming from".

Jo is a designer. Not a programmer. Designer are not trained to be
programmers. That only happens with experience, if your lucky.

I've worked on multi-million dollar projects with designer just like Jo.

It took me 2 weeks to get the flow and concepts out these designers. The
client was pissed (we worked by the hour), but, after a calm walk through of
what we were given from the designers, and the process we had to go through
to get what "they" imaged, the client understood and then chastised the
designers and made them pay for some of our hours. They learned the hard way
as well. :)

You have to read between the lines. You have to look at Jo's images, what
notes he has, and put the puzzle together yourself.

Yes, lot more work, many more hours. I hope your doing this by the hour and
not a flat fee.

If not, you just had a learning experience. You would do this again, will
you! ;)

If you like, I can lend a hand and try to interrupt what you were given. I
work cheap, not free.

Good luck.

Walter
Jul 17 '05 #4
Ken
On Wed, 02 Jun 2004 09:41:48 GMT, "Khen Chzakuv" <no**@none.com>
wrote:
Fred wants an e-commerce website. He commissions Jo, a freelancer who is a good web
designer and knows a little about programming (from an extremely sub-standard
university), to create the website for him. Jo sets to work creating lots of pretty HTML
pages with calls to as-yet-unwritten PHP scripts mixed in with the HTML and Javascript.


Hello: New php-er here.

I have seen this message before virtually word for word in another
newsgroup maybe a year ago, which leads me to believe that it might be
from a class assignment?

Ken
Jul 17 '05 #5

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

21
by: Dave | last post by:
After following Microsofts admonition to reformat my system before doing a final compilation of my app I got many warnings/errors upon compiling an rtf file created in word. I used the Help...
9
by: Tom | last post by:
A question for gui application programmers. . . I 've got some GUI programs, written in Python/wxPython, and I've got a help button and a help menu item. Also, I've got a compiled file made with...
6
by: wukexin | last post by:
Help me, good men. I find mang books that introduce bit "mang header files",they talk too bit,in fact it is my too fool, I don't learn it, I have do a test program, but I have no correct doing...
3
by: Colin J. Williams | last post by:
Python advertises some basic service: C:\Python24>python Python 2.4.1 (#65, Mar 30 2005, 09:13:57) on win32 Type "help", "copyright", "credits" or "license" for more information. >>> With...
7
by: Corepaul | last post by:
Missing Help Files When I enter "recordset" as the keyword and search the Visual Basic Help index, I get many topics of interest in the resulting list. But there isn't any information available...
5
by: Steve | last post by:
I have written a help file (chm) for a DLL and referenced it using Help.ShowHelp My expectation is that a developer using my DLL would be able to access this help file during his development time...
8
by: Mark | last post by:
I have loaded Visual Studio .net on my home computer and my laptop, but my home computer has an abbreviated help screen not 2% of the help on my laptop. All the settings look the same on both...
10
by: JonathanOrlev | last post by:
Hello everybody, I wrote this comment in another message of mine, but decided to post it again as a standalone message. I think that Microsoft's Office 2003 help system is horrible, probably...
1
by: trunxnirvana007 | last post by:
'UPGRADE_WARNING: Array has a new behavior. Click for more: 'ms-help://MS.VSCC.v80/dv_commoner/local/redirect.htm?keyword="9B7D5ADD-D8FE-4819-A36C-6DEDAF088CC7"' 'UPGRADE_WARNING: Couldn't resolve...
0
by: hitencontractor | last post by:
I am working on .NET Version 2003 making an SDI application that calls MS Excel 2003. I added a menu item called "MyApp Help" in the end of the menu bar to show Help-> About. The application...
0
by: DolphinDB | last post by:
Tired of spending countless mintues downsampling your data? Look no further! In this article, you’ll learn how to efficiently downsample 6.48 billion high-frequency records to 61 million...
0
by: ryjfgjl | last post by:
ExcelToDatabase: batch import excel into database automatically...
1
isladogs
by: isladogs | last post by:
The next Access Europe meeting will be on Wednesday 6 Mar 2024 starting at 18:00 UK time (6PM UTC) and finishing at about 19:15 (7.15PM). In this month's session, we are pleased to welcome back...
0
by: Vimpel783 | last post by:
Hello! Guys, I found this code on the Internet, but I need to modify it a little. It works well, the problem is this: Data is sent from only one cell, in this case B5, but it is necessary that data...
0
by: jfyes | last post by:
As a hardware engineer, after seeing that CEIWEI recently released a new tool for Modbus RTU Over TCP/UDP filtering and monitoring, I actively went to its official website to take a look. It turned...
0
by: ArrayDB | last post by:
The error message I've encountered is; ERROR:root:Error generating model response: exception: access violation writing 0x0000000000005140, which seems to be indicative of an access violation...
1
by: CloudSolutions | last post by:
Introduction: For many beginners and individual users, requiring a credit card and email registration may pose a barrier when starting to use cloud servers. However, some cloud server providers now...
1
by: Shællîpôpï 09 | last post by:
If u are using a keypad phone, how do u turn on JavaScript, to access features like WhatsApp, Facebook, Instagram....
0
by: Faith0G | last post by:
I am starting a new it consulting business and it's been a while since I setup a new website. Is wordpress still the best web based software for hosting a 5 page website? The webpages will be...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.