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: Content Fusion: How do we capture and store the discussion if we use this for spec reviews?


https://www.oxygenxml.com/doc/versions/5.0/ug-content-fusion/topics/making_changes_to_uploaded_files-x2.html?hl=download#making_changes_to_uploaded_files__saving_files

 

Saving Files

All of your changes are saved automatically on the Oxygen Content Fusion server. If you want to save a file manually, use the Save button on the toolbar or the Ctrl + S (Command + S on macOS) keyboard shortcut. You can also download the file to your local file system by selecting More / Download.

The Get Changes feature from the Editor should perform the same function, so not sure why you aren’t seeing these comments?

 

--Scott

 

From: kris eberleinconsulting.com <kris@eberleinconsulting.com>
Date: Friday, June 10, 2022 at 11:29 AM
To: Scott Hudson <scott.hudson@servicenow.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?

[External Email]

 

OK, so you are not “getting the changes” from within Oxygen, but downloading the topic?

 

From where are you downloading the topic? And is there functionality to download the entire set of topics in the review?

 

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 1:18 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?

 

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&apos;s not new. It&apos;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&apos;ve corrected this in the DITA source. Thanks for noticing this." flag="done" mid="2"?>&lt;/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

 



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