Fwd: Re: [dita] Adoption Committee whitepapers

[Kristen James Eberlein <kris@eberleinconsulting.com>]

Just to make sure that the Adoption TC saw this also.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)

-------- Forwarded Message --------

Subject:	Re: [dita] Adoption Committee whitepapers
Date:	Tue, 22 Dec 2015 08:19:40 -0500
From:	Kristen James Eberlein <kris@eberleinconsulting.com>
To:	dita@lists.oasis-open.org

The PDF is ... a little bizarre.

The topics seems to have a shortdesc that was perhaps just intended to be authoring notes? And intended to be filtered out? For example:

Good Short Descriptions = Better Search Engine Results for Online Documents
Demonstrates how short descriptions appear within search engine results, and how they can enhance Search Engine
Optimization (SEO).

Short descriptions appear in search engine results. Well-written short descriptions lets a search engine know that
the information it seeks is in your document. When a short description is absent, by default the first sentence or two
appears in its place, which rarely summarizes what the content of a topic is about.

Conclusion
Summing up why short descriptions are a good idea.

Though <shortdesc> is an optional element, when used effectively it is a useful guide to readers and content creators
alike. When done well, short descriptions tell the reader why they might want to read the content of a given topic, and
can help content creators decide which topic is appropriate for reuse.

I don't think this is ready for prime time.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)

On 12/21/2015 8:41 PM, Bob Thomas wrote:

Hi,

The shortdesc whitepaper is out for second draft review. This first draft went out before the Adoption Committee began using the current review process. For many of you, this will be the first that you have heard about the shortdesc whitepaper. Therefore, I have attached it, and I invite you to review it.

A whitepaper describing help features is in the works. Tony self and Stan Doherty are doing a subject matter expert reading of it. Once they are done, the whitepaper will go out for first draft review.

Best Regards,

--

Bob Thomas

+1 720 201 8260

Skype: bob.thomas.colorado

Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype

Time zone: Mountain (GMT-7)

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that 
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php