Skip to content

citationTree: add more examples/descriptions in spec #277

@kbrueckmann

Description

@kbrueckmann

The specs mention:

The depth of a citation tree can be uneven. In a Ph.D. thesis, for example, the introduction may not be subdivided, while a chapter will often have subdivisions.

Would the following citationTree be sufficient in describing this fictional thesis (with the structure of either chapter->paragraph or chapter->section->paragraph)?

"citationTrees": [
    {
        "@type": "CitationTree",
        "citeStructure": [
            {
                "citeType": "chapter",
                "citeStructure": [
                    {
                        "citeType": "section",
                        "citeStructure": [
                            {
                                "citeType": "paragraph"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

This would mean that any descendant unit (here: paragraph) might appear directly after any of its ancestors (here: chapter). So, in a chapter, one might encounter either a section or a paragraph.

Or would I have to adjust the citationTree in such a way that all possible nested unit structures (chapter->paragraph and chapter->section->paragraph) are explicitly mentioned, e.g.:

"citationTrees": [
    {
        "@type": "CitationTree",
        "citeStructure": [
            {
                "citeType": "chapter",
                "citeStructure": [
                    {
                        "citeType": "section",
                        "citeStructure": [
                            {
                                "citeType": "paragraph"
                            }
                        ]
                    },
                    {
                        "citeType": "paragraph"
                    }
                ]
            }
        ]
    }
]

I think a few more examples of different – possibly more complicated – text structures (as graph diagram or as a short textual description) plus their corresponding citationTrees might be really helpful in the specs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    DocumentationIssues related to documentation typos, design, etc.

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions