-
Notifications
You must be signed in to change notification settings - Fork 63
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Clarifying comments in checklist-mapper file #6654
base: master
Are you sure you want to change the base?
Conversation
Signed-off-by: Emily Rodriguez <[email protected]>
* @extends ChecklistJsonixConverter | ||
* | ||
* @property {string | ExecJSON.Execution} data - The input data, which can be a string of XML data or an HDF JSON execution object. | ||
* @property {Checklist} jsonixData - The JSON representation of the checklist data. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd revise this statement to explain better that it's like the jsonix, direct conversion of the ckl, js checklist data in comparison to the intermediate representation which cleans it up and makes it easier to use.
* @property {ChecklistObject} checklistObject - The intermediate object representation of the checklist data. | ||
* @property {boolean} withRaw - A flag indicating whether to include raw data in the output. | ||
* | ||
* @constructor |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
why are we defining the constructor parameters both here and on top of the constructor?
* @param {string | ExecJSON.Execution} data - The input data, which can be a string of XML data or an HDF JSON execution object. | ||
* @param {boolean} [withRaw=false] - Optional flag indicating whether to include raw data in the output. | ||
* | ||
* @method getJsonix |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should this info be here or directly on top of the corresponding function?
* @returns {Checklist} - Returns the JSON representation of the checklist data. | ||
* | ||
* @method toCkl | ||
* @returns {string} - Converts the checklist data to CKL (Checklist) XML format. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
converts the jsonix json representation of the ckl data into the xml format
* @returns {string} - Converts the checklist data to CKL (Checklist) XML format. | ||
* | ||
* @method toHdf | ||
* @returns {ExecJSON.Execution} - Converts the checklist data to HDF (Heimdall Data Format). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
converts the intermediate format ckl data into hdf
Signed-off-by: Emily Rodriguez <[email protected]>
|
There were inaccurate / confusing comments in the checklist mapper. Hopefully this represents the code accurately. Please review and provide feedback.
Is intakeType still used? If so, what is it and how?