OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: RE: [dita] Review of Proposals 13010 and 13031


Hi Folks.

I thought I'd chime in with a semiconductor perspective. The overline can be used to indicate an "active low" signal, for example:

<overline>RESET</overline>

I think the general purpose "overline" element is the way to go, and if we decide to use this element in a more specific way, we would create a specialization of overline called "active-low":

<active-low>RESET</active-low>

Having a DITA-provided basis for marking up content that is typically decorated by an overline is a good start which may have other uses in its generic form. I think any further refinement of the semantics and styling needs to occur by the implementer (or an industry-specific group, such as SIDSC). 

If we omit having "overline" as a base type, then we'd preclude other uses (and specialization opportunities) such as for repeating decimal patterns. An engineering publisher could represent active-low signals and repeating decimal patterns with the same generic "overline" element. Or, such a publisher could further specialize if doing so presented some additional advantage. 

FWIW, I considered the lack of "overline" support in previous DITA versions to be an oversight. We were able to achieve it with specialization, but I'm happy to see that it will likely be part of 1.3.


-seth park


-----Original Message-----
From: dita@lists.oasis-open.org [mailto:dita@lists.oasis-open.org] On Behalf Of Buchholz, Thilo
Sent: Tuesday, July 16, 2013 8:29 AM
To: Eliot Kimber
Cc: dita
Subject: RE: [dita] Review of Proposals 13010 and 13031

Hi Eliot,

I agree with the semantic of the registers, that is fine with me. But wouldn´t I just tag the corresponding text as <register>text</register> and let the style sheet create the overline.

The symmetry argument feels to much like formatting to me but on the other side a lot of DITA elements are kind of formatting may and symmetry could be an argument to be future-proof.

BR Thilo  

-----Original Message-----
From: Eliot Kimber [mailto:ekimber@rsicms.com]
Sent: Dienstag, 16. Juli 2013 15:18
To: Buchholz, Thilo
Cc: dita
Subject: Re: [dita] Review of Proposals 13010 and 13031

Overline is not restricted to formulas, that's just one obvious use.
Overline is a common convention in semiconductor content to indicate details about registers and pins and whatnot. You can also see it as providing symmetry with underline and line-through, that is, providing the third option for where a line can go relative to the characters.

Cheers,

E.

On 7/15/13 1:35 AM, "Buchholz, Thilo" <thilo.buchholz@sap.com> wrote:

> Hello Eliot,
>  
> I did review both proposals they are well done and I am fine with them.
>  
> The only question I had was about the semantics of ³overline² in 
> proposal 13031. If this is restricted to formulas I would prefer not 
> to allow it outside of the mathml integration.
>  
> BR Thilo
>  
> Dr. Thilo Buchholz
> Chief Knowledge Transfer Architect and SAP Internal Coach Knowledge 
> Productization Services
> SAP AG    
> T   +49/62 27/76 13 31
> M  +49/170/2 20 01 17
>  
> Searching for SAP Internal Coaches?
> <https://ipp.wdf.sap.corp/sap/bc/webdynpro/sap/zwdm4u_coach?sap-langua
> ge=en>
>  
>  
>  

--
Eliot Kimber
Senior Solutions Architect, RSI Content Solutions "Bringing Strategy, Content, and Technology Together"
Main: 512.554.9368
www.rsicms.com
www.rsuitecms.com
Book: DITA For Practitioners, from XML Press, http://xmlpress.net/publications/dita/practitioners-1/


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





[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]