Re: "Internet Standard (STD)" - phrase known by Web programmers ?

Subject: Re: "Internet Standard (STD)" - phrase known by Web programmers ?
From: "Monique Semp" <monique -dot- semp -at- earthlink -dot- net>
To: "TechWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 23 May 2012 12:13:49 -0700

I would say something like "if your XSD conforms to the XML Schema
Specification you should not experience
Parsing failures as a result of an update."

Ah, but the issue is that it's not whether the XML doc conforms to the schema. The point I need to make in the doc is that the reader must actually USE the XSD instead of just trying to use the XML file directly (both the XSD and XML files are provided to them). And when the user neglects to use the XSD, and it and the XML file change, then the user's processing of the XML of course fails.

So it's not a matter of whether there's conformance; it's a matter of educating these unknowledgeable Web programmers in the doc audience how to do things right.

But on to the bigger issue...

<rant>
I was told again to use "internet standards", not even capitalized, and definitely to not include any additional guidance or info, because, and I quote the developer *and* his manager, "Clarity is not needed in this regard."

Why would it be ok to write something that we know is not clear?

I am pushing back on this, but I fear that I may fail :-(
</rant>

Thanks for listening,
-Monique



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.

http://bit.ly/doc-to-help

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
Re: "Internet Standard (STD)" - phrase known by Web programmers ?: From: Laura Lemay

Previous by Author: Re: "Internet Standard (STD)" - phrase known by Web programmers ?
Next by Author: Re: Easy photo knockout (masking)
Previous by Thread: Re: "Internet Standard (STD)" - phrase known by Web programmers ?
Next by Thread: Re: "Internet Standard (STD)" - phrase known by Web programmers ?


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads