Re: IP-XACT to DITA?

Dave, Severin;

I'm trying to get caught up on this thread as I sit in a coffee shop waiting for the start of a 3-day training session on agile program management, followed by 2 weeks of holiday. So this won't be a very complete answer to your questions, but I didn't
 want to let your message go unanswered for too long.

I've cc'd the SIDSC maillist so that others in the subcommittee can chime in with thoughts (sorry that you won't be able to respond directly to that maillist until Altera's OASIS membership is active).

The data flow you've described below is definitely one of the most critical issues that we're attempting to address with the SIDSC specializations. You'll be pleased to know that the SIDSC register description model has close to a 1-to-1 correlation with
 the IP-XACT component description model. In fact, when the SC began the work of defining a set of DITA specializations to capture all of the data required to document SoC register sets, we began by looking at the IP-XACT 1.4 structure as a starting point.
 Due to the more robust requirements of technical documentation versus EDA tools, the SIDSC register specializations are actually a superset of IP-XACT 1.4. Thus, it is very simple to produce IP-XACT from SIDSC. The opposite flow isn't quite a simple, as a
 straight ipxact2sidsc transform leaves a lot of "holes" in the SIDSC that must be filled in via some adjunct flow (such as a person manually entering the missing pieces).

If Altera has built strong IP-XACT workflows for your SoC design teams, leveraging that data into a DITA-based publishing system can be very effective. What we've found at Freescale is that treating the SIDSC content as the "gold  master" is more effective,
 as that superset data can be transformed into IP-XACT as needed, but also into many, many other formats (including human-readable documentation).

Enough for now ... I'll look forward to working together to solve our industry's problems!

Regards,

Bob

Sent from my iPad

On Dec 13, 2012, at 5:16 PM, "Dave Walker" <> wrote:

Yes, thanks Kris, I understand IP-XACT is governed by the Spirit Consortium.  What I am interested in is ways to seamlessly move data from the IP-XACT engineering
 world to the DITA documentation world.  The issues Altera faces certainly are common issues the industry as a whole faces, and thus, I suspect there are some pieces in place and some yet to be determined.  Altera joining OASIS will help and I’m looking for
 what might already be available in the meantime.  I look forward to hearing from Bob…
J

 

Thanks,

Dave

 

Dave Walker

Technical Documentation Engineer, System IP Documentation

Altera Corporation

408-544-8524



 

From: Kristen James Eberlein [mailto:]

Sent: Thursday, December 13, 2012 2:04 PM

To: Carol Geyer

Cc: Dave Walker; ; Severin Foreman; Barbara Erbes; Don Day; Robin Cover; Bob Beims

Subject: Re: IP-XACT to DITA?

 

Perfect, Carol -- thanks!

Dave,IP-XACT is not an OASIS standard. If you are interested purely in 
IP-XACT, you'll  want to contact IEEE or the Spirit consortium.

But I think what you are interested in is the work of the Semiconductor Information Design subcommittee, which is a subcommittee of the DITA Technical Committee. Bob Beims is the chair.

Best,

Kris

Kristen James Eberlein

Principal consultant, Eberlein Consulting

Co-chair, OASIS DITA Technical Committee

Charter member, OASIS DITA Adoption Committee

www.eberleinconsulting.com

+1 919 682-2290; kriseberlein (skype)

On 12/13/2012 4:56 PM, Carol Geyer wrote:

I'm adding Bob Beims, chair of the DITA Semiconductor Information Design Subcommittee (SIDSC) to this thread. Bob may be the best person to answer your questions.

 

On Thu, Dec 13, 2012 at 4:52 PM, Dave Walker <> wrote:

Fabulous!  What IP-XACT related information might we be able to have access to now?  Any?  Who can
 I start communicating with at OASIS about IP-XACT?

 

Here are the kinds of things I’m exploring between now and the end of the year.

-         
Do any of you know of a company in France named Magillem?  Altera Engineering is using their products and they apparently are heavily involved in DITA.

-         
Is OASIS SIDSC the committee in charge of IP-XACT?

-         
Is OASIS SIDSC aware of the Spirit consortium that controls IP-XACT format?

 

Thanks,

Dave

 

Dave Walker

Technical Documentation Engineer, System IP Documentation

Altera Corporation

408-544-8524



 

From: Severin Foreman

Sent: Thursday, December 13, 2012 1:16 PM

To: Carol Geyer

Cc: Dave Walker; Barbara Erbes; Don Day; Kristen James Eberlein

Subject: RE: IP-XACT to DITA? 

 

Thanks, Carol. We do plan to join in Q1, but it depends on when we can allocate our budget money.
 I can say for sure that there is a lot of excitement on our team to join as soon as possible.

 

Severin

 

From: Carol Geyer [mailto:]

Sent: Thursday, December 13, 2012 1:08 PM

To: Severin Foreman

Cc: Dave Walker; Barbara Erbes; Don Day; Kristen James Eberlein

Subject: Re: IP-XACT to DITA?

 

Severin,

This is great news. Do you think you'll be joining in the first quarter or later in the year? Please let me know if there is anything you need from us at this point.

All the best,

Carol

 

On Thu, Dec 13, 2012 at 3:59 PM, Severin Foreman <> wrote:

I am happy to report that Altera is planning to join OASIS in 2013 at the Sponsor level. We look
 forward to getting involved!

 

Best regards,

Severin Foreman

Technical Communications Information Architect

Altera Corporation

101 Innovation Drive | San Jose,  CA 95134

ph.
(408) 544-7766

m. 
(512) 809-5775

 

 

 

From: Carol Geyer [mailto:]

Sent: Thursday, December 13, 2012 12:52 PM

To: Dave Walker

Cc: Barbara Erbes; Don Day; Kristen James Eberlein; Severin Foreman

Subject: Re: IP-XACT to DITA?

 

Altera is not a current or former member of OASIS.

~Carol

 

On Thu, Dec 13, 2012 at 3:44 PM, Dave Walker <> wrote:

Thanks!  Can you tell me if my company, Altera, is or has been a member?  And if so, who the Altera
 contacts were/are?

 

Thanks,

Dave

 

Dave Walker

Technical Documentation Engineer, System IP Documentation

Altera Corporation

408-544-8524



 

From: Carol Geyer [mailto:]

Sent: Thursday, December 13, 2012 12:16 PM

To: Dave Walker

Cc: Barbara Erbes; Don Day; Kristen James Eberlein

Subject: Re: IP-XACT to DITA?

 

Dave,

We'd be happy to have you participate in the OASIS DITA Technical Committee.

The OASIS DITA TC co-chairs, Kristen Eberlein and Don Day, can address any questions you might have about the work.

I can help with membership. Our categories and dues are detailed at:

https://www.oasis-open.org/join/categories-dues

For a corporate membership, simply submit the Membership Agreement at:

https://www.oasis-open.org/join/membership-agreement.pdf

For a personal membership, use the Agreement at:

http://www.oasis-open.org/join/membership-agreement-ia.pdf

Please let me know if you have any questions at all.

Best regards,

Carol

 

 

-------- Original Message --------

Subject: 

IP-XACT to DITA?

Date: 

Wed, 12 Dec 2012 18:59:17 -0800

From: 

Dave Walker
<>

To: 


<>,
 
<>, 
 
<>, 
 
<>, 
 
<>

 

Found this and other old emails online and wonder how I can get involved.  I am especially interested in IP-XACT to DITA.  Thx!

 

  This is just a note to remind everyone that you must be a member of OASIS as well as a member of the
 DITA technical committee to participate in the Semiconductor Information Design Subcomittee work. If you or your company is not yet an OASIS member but would like to participate, please contact
; if your organization is a member of OASIS but you're not sure how to sign up for your own membership or the technical committee, please feel free to contact Barbara
 Erbes at  for assistance.

 

Thanks,

Dave

 

Dave Walker

Technical Documentation Engineer, System IP Documentation

Altera Corporation

408-544-8524



 

 

Confidentiality Notice.

This message may contain information that is confidential or otherwise protected from disclosure. If you are not the intended recipient, you are hereby notified that any use, disclosure, dissemination, distribution, or copying of this message, or any attachments,
 is strictly prohibited. If you have received this message in error, please advise the sender by reply e-mail, and delete the message and any attachments. Thank you.