If I have a content with added comments, does it means that the bpm_package.children[0] is the document, while bpm_package.children[1] and so on is the comments?
no, It is not like that. bpm_package.children is array of all contents within that workflow instance and as there can be more then one contents in one workflow intance this is array.