RE: [dita] Introduction to DITA topics ( Was "Re: Where to locate the conformance topic")

["Gershon Joseph (gerjosep)" <gerjosep@cisco.com>]

I think we need an "Introduction to the DITA Specification" topic that I
think is what Eliot is referring to, separate from and independent of
the "Introduction to DITA" topic that serves a totally different
purpose.

Gershon

-----Original Message-----
From: Kristen James Eberlein [mailto:keberlein@pobox.com] 
Sent: Tuesday, September 01, 2009 4:18 PM
To: ekimber
Cc: dita
Subject: [dita] Introduction to DITA topics ( Was "Re: Where to locate
the conformance topic")

Elliot, your comments indicate that you've taken the "Introduction to
DITA" section in a different direction than it was previously. (No value
judgment on my part, but I want to keep matters clear.)

Up to now, the "Introduction to DITA" was a introductory section in the
Architectural Specification; it introduced those topics, not the
Language Reference topics.

It sounds as if you want the "Introduction to DITA" topics to introduce
both the Architectural Specification and the Language Reference. I think
we need to talk about that, especially since what you are suggesting
potentially has a big effect on the Lang Ref topics and might introduce
significant work for Robert ...

Kris

ekimber wrote:
> On 9/1/09 7:35 AM, "Kristen James Eberlein" <keberlein@pobox.com>
wrote:
>
>   
>> Elliot, sounds as if we need to discuss this. Off the topic of my 
>> head, here's what I would suggest:
>>
>> Overview [Unique for each of the three packages/document variations] 
>> Conformance statement Architectural Specification Language Reference
>>
>> This keeps "Introduction to DITA" as a component of the architectural

>> specification.
>>     
>
> The problem I see with that approach is that the Intro provides much 
> of the terminology that the Conformance section uses. Also, the Intro 
> serves an intro to both the arch spec and lang ref, so from that 
> standpoint it makes sense to me for it to be a peer to both.
>
> Cheers,
>
> E.
>
> ----
> Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc.
> email:  ekimber@reallysi.com <mailto:ekimber@reallysi.com>
> office: 610.631.6770 | cell: 512.554.9368 2570 Boulevard of the 
> Generals | Suite 213 | Audubon, PA 19403 www.reallysi.com 
> <http://www.reallysi.com>  | http://blog.reallysi.com 
> <http://blog.reallysi.com> | www.rsuitecms.com 
> <http://www.rsuitecms.com>
>
>
>
>   



---------------------------------------------------------------------
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