Re: Business issues, documentation and editors

[Andrew Plato <intrepid_es -at- yahoo -dot- com>]

"Darren Barefoot" wrote

>. If anyone's interested, there are PDF
> (http://www.capeclear.com/products/manuals/three/Concepts/pdf/cc3_concep
> ts.pdf) and HTML
> (http://www.capeclear.com/products/manuals/three/Concepts/html/)
> versions available on the Web. If anyone's interested in Web Services
> generally, I think this book gives a readable, half-decent introduction
> to them as well.

Nice docs. Good read. Very well done. 

And SOAP...so very hackable. Just HTTP packets (or HTTPS). Its RPC over
HTTP! Sniff 'em, hack 'em, grab the credit cards! Oh and don't even get me
started of apps with SMTP open to objects. That's delicious. Like a great
big digital cow teet just waiting to be milked for information. 

Whoa - there's an image for ya! 

Sorry, there's some HUGE security holes in SOAP based systems. Security
jerks like me get off on that stuff. 

> This telling of a story is my point. I often give this advice about
> writing white papers, which are often all about the "why". Telling a
> story--describing in narrative terms how your product is solving a
> problem--is an excellent way to address the "why". It may be as simple
> as a few introductory paragraphs. However, ideally (and my "Concepts"
> manual is not a good example of this), the story should run through the
> entire doc set. This may mean using consistent and extended  examples
> through the book(s), referring back to the introductory story or using
> recurring visual elements to remind the user of the greater
> problem/solution idea.

Right on, bro! You are switched on! You are a 200 megawatt kitten
snuggling extravaganza! 

In other words, couldn't agree with you more Darren.

I like concept diagrams. Pretty pictures and maps the show how a complex
concept is organized. That dazzles them and delivers value. 

Andrew "Cow Teets" Plato 

__________________________________________________
Do You Yahoo!?
Send FREE video emails in Yahoo! Mail!
http://promo.yahoo.com/videomail/

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you 
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of 
your book. What are you waiting for? http://www.iuniverse.com/media/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit 
http://www.raycomm.com/techwhirl/ for more resources and info.