commentOnId uses objectId

[mzkhuzam]

I realized that commentOnId uses objectId which must be obtained from the metadata, users have to first use get_documents in order to obtain the objectId for a document. Alternatively, documentIds are public-facing on regulations.gov and included in the metadata.

Not sure if one obtains more information than the other but flagging this as something to deal with in documentation and maybe deal with later. I don't want to create two functions that do the same thing ...

[judgelord]

yes, our current draft documentation specifies two functions:

Get metadata for comments on a document or docket

• get_comments_on_docket("[docket_id]") retrieves all comments for a docket (e.g., including an Advanced Notice of Proposed Rulemaking and all draft proposed rules)

• get_comments_on_document("[document_id]") retrieves comments on a specific document (e.g., a specific proposed rule)

However, they could probably just be one get_comments function that takes a docket = or document_id argument...or maybe even detects whether a docket id, document id, or object id is supplied.