Skip to content
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

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

em-c-rod
Copy link
Contributor

@em-c-rod em-c-rod commented Feb 20, 2025

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?

@em-c-rod em-c-rod self-assigned this Feb 20, 2025
@em-c-rod em-c-rod requested a review from Amndeep7 February 20, 2025 17:45
* @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.
Copy link
Contributor

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
Copy link
Contributor

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
Copy link
Contributor

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.
Copy link
Contributor

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).
Copy link
Contributor

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants