When I downloaded the topic, I see comments like:
<b><?oxy_comment_start author="Gershon Joseph" timestamp="20220606T120534+0000" comment="The end tag for the preceding optional element should not
be marked in bold, since it's not new. It's part of the current, existing spec code." id="xpb_rtb_5tb" flag="done"?><?oxy_comment_start author="Kristen James Eberlein" timestamp="20220606T133717+0000" parentID="xpb_rtb_5tb" comment="I've corrected
this in the DITA source. Thanks for noticing this." flag="done" mid="2"?></optional><?oxy_comment_end mid="2"?><?oxy_comment_end?>
So I do think the comments are getting captured in the source as expected?
--Scott
From:
dita@lists.oasis-open.org <dita@lists.oasis-open.org> on behalf of kris eberleinconsulting.com <kris@eberleinconsulting.com>
Date: Friday, June 10, 2022 at 11:14 AM
To: DITA Technical Committee (dita@lists.oasis-open.org) <dita@lists.oasis-open.org>
Subject: [dita] RE: Content Fusion: How do we capture and store the discussion if we use this for spec reviews?
[External Email]
I certainly do not see any Oxygen processing instructions when I “Get changes” from the Content Fusion Tasks Manager view.
Can you run some tests and see what the possibilities are for capturing the comments? Off the top of my head, I think of the following (not-so-great) manual possibilities:
- Have reviewers enter all comments as draft comments in the source, merge the draft comments, build and archive a PDF that renders the draft comments
- Copy and paste all the comments into a document, save the document, archive a PDF. (It’s easy to get all the comments, but we lose all context; there
is no indication as to what content in the document the comment applies to.
Scott, I’m hoping you can find better options.
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Owner, Eberlein Consulting LLC
kris@eberleinconsulting.com
Skype: kriseberlein; voice: +1 (919) 622-1501
From: Scott Hudson <scott.hudson@servicenow.com>
Sent: Friday, June 10, 2022 12:58 PM
To: kris eberleinconsulting.com <kris@eberleinconsulting.com>; DITA Technical Committee (dita@lists.oasis-open.org) <dita@lists.oasis-open.org>
Subject: Re: Content Fusion: How do we capture and store the discussion if we use this for spec reviews?
I think comments are still tracked as oxygen processing instructions in the source?
--Scott
From:
dita@lists.oasis-open.org <dita@lists.oasis-open.org> on behalf of kris eberleinconsulting.com <kris@eberleinconsulting.com>
Date: Friday, June 10, 2022 at 10:53 AM
To: DITA Technical Committee (dita@lists.oasis-open.org) <dita@lists.oasis-open.org>
Subject: [dita] RE: Content Fusion: How do we capture and store the discussion if we use this for spec reviews?
[External Email]
I think that the changes covered in the Oxygen documentation are strictly changes that were made in the source. I’m talking about the comments that reviewers can make by selecting something in the document
under review, and then clicking the “Add comment” button.
For example, from the current Content Fusion review at
https://fusion.oxygenxml.com/tasks/3dgikmnbacaj012ue4qu2ikmhqsn4u8m8iqebsmcgjodkl3t/ , we have the following discussion:
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Owner, Eberlein Consulting LLC
kris@eberleinconsulting.com
Skype: kriseberlein; voice: +1 (919) 622-1501
From: Scott Hudson <scott.hudson@servicenow.com>
Sent: Friday, June 10, 2022 12:35 PM
To: kris eberleinconsulting.com <kris@eberleinconsulting.com>; DITA Technical Committee (dita@lists.oasis-open.org) <dita@lists.oasis-open.org>
Subject: Re: Content Fusion: How do we capture and store the discussion if we use this for spec reviews?
Generally, you can capture and store the comments when you download the changes to local oxygen and can then check those files with comments into the repo?
https://www.oxygenxml.com/doc/versions/5.0/ug-content-fusion/topics/merging_changes.html?hl=merge
HTH,
--Scott
From:
dita@lists.oasis-open.org <dita@lists.oasis-open.org> on behalf of kris eberleinconsulting.com <kris@eberleinconsulting.com>
Date: Friday, June 10, 2022 at 2:16 AM
To: Scott Hudson <scott.hudson@servicenow.com>, DITA Technical Committee (dita@lists.oasis-open.org) <dita@lists.oasis-open.org>
Subject: [dita] Content Fusion: How do we capture and store the discussion if we use this for spec reviews?
[External Email]
Hi, Scott (and other TC members).
And so the challenging work begins. How can we capture and store the discussion that happens during a review of spec content if we use Content Fusion? I think the current review for the stage three proposal
#647, “Remove classification domain and add new attribute” will work as a good test case. Take a look:
https://fusion.oxygenxml.com/tasks/3dgikmnbacaj012ue4qu2ikmhqsn4u8m8iqebsmcgjodkl3t/
The review is not yet complete, but I don’t think that matters.
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Owner, Eberlein Consulting LLC
kris@eberleinconsulting.com
Skype: kriseberlein; voice: +1 (919) 622-1501