Missing EBA documentation in table definition

[sebgerber]

When loading a table definition from a file, we are missing the eba:documentation part. The datapoint of the an eba table definition is like this :

"dp12679": {
    "decimals": "$decimalsMonetary",
    "dimensions": {
        "concept": "eba_met:qJJH",
        "eba_dim_3.4:APR": "eba_AP:x6",
        "eba_dim_3.4:PIN": "eba_PI:x1",
        "eba_dim_3.4:RSP": "eba_RS:x2",
        "eba_dim_3.4:TRI": "eba_TR:x21",
        "eba_dim_4.0:qAFF": "eba_qFI:qx2195",
        "eba_dim_4.0:qEEF": "eba_qPL:qx2002",
        "eba_dim_4.0:qJNL": "eba_qPL:qx2072",
        "eba_dim_4.0:qKMM": "eba_qST:qx2010",
        "eba_dim_4.0:qZZX": "eba_qOR:qx2007",
        "unit": "$baseCurrency"
    },
    "eba:documentation": {
        "CellID": 62549,
        "ColumnVID": 223257,
        "FactVariableID": 12679,
        "FactVariableVersionID": 3214049,
        "RowVID": 229429,
        "SheetVID": null,
        "cellcode": "{C_20.00, r0030, c0010}",
        "type": "m"
    }
},

At the moment, only the sections decimals and dimensions are loaded in the class PropertyGroup. It would be great to also have the eba:documentation section.
Any EBA report has this section and can be used for testing. The files in the test project already contains it : https://github.com/dgm9704/Xoxo/blob/main/Diwen.Xbrl.Tests/www.eba.europa.eu/eu/fr/xbrl/crr/fws/finrep/its-005-2020/2022-06-01/tab/f_13.02.1.a/f_13.02.1.a.json#L43

[dgm9704]

Ok, so there are couple of ways about this.

One is the seemingly straightforward way of adding EbaDocumentation as property of type EbaDocumentation. I really don't like that there are "vendor specific" things included, BUT there already is eba:generatingSoftwareInformation so this isn't new in that sense. This however requires that there is some sort of specification for the eba:documentation structure so I can implement that as properties. I can already see that those have changed since the first implementation. Probably this lack of docs/instability was the reason I skipped doing this originally.

The other way is to implement "vendor specific" things as JsonExtensionData. This works fine but on its own is a tiny bit tedious to code around. That would be improved by adding extension properties that would parse the data they understand from the JsonElements. The end result would look the same as with the first way, but would allow for changes or additions to the file be available without requiring changes to the library, and it would make things a little bit cleaner as the "vendor specific" stuff would be outside the "generic" implementation. Sadly extension properties are only available in .NET10/C#14, so the extensions would be methods.

I will very likely go forward with the first way. The second way can be implemented afterwards without breaking compatibility.

[dgm9704]

@sebgerber would you be comfortable with providing some details on your use case?
Like what would the logic around it look like, what you would do with the information etc.
Either here or via email or some other channel if you prefer.
I don't mean you need to justify the implementation, but I would like to know what would be the best way to do this,
so that it is actually useful while still performant, easy to maintain, as simple as possible, future proof etc.
I might be overthinking this but I see different ways to implement and I'm having a hard time deciding.
I'll also be asking EBA for documentation or specifications on this since I haven't found any yet.

[dgm9704]

www.eba.europa.eu/eu/fr/xbrl/crr/fws/corep/4.0/tab/c_48.02/c_48.02.json

            "columns": {
                "RDT": {
                    "eba:documentation": {
                        "KeyVariableID": "199028",
                        "KeyVariableVID": "199028",
                        "PropertyID": "1012400244",
                        "headerCode": "0010",
                        "headerDirection": "X",
                        "headerVID": "74914",
                        "type": "d"
                    }
                },
                "datapoint": {
                    "propertyGroups": {
                        "dp454521": {
                            "decimals": "$decimalsMonetary",
                            "dimensions": {
                                "concept": "eba_met:qNHH",
                                "eba_dim_3.4:APR": "eba_AP:x108",
                                "eba_dim_4.0:qAFF": "eba_qFI:qx2213",
                                "unit": "$baseCurrency"
                            },
                            "eba:documentation": {
                                "CellID": 74106,
                                "ColumnVID": 223217,
                                "FactVariableID": 454521,
                                "FactVariableVersionID": 3265251,
                                "RowVID": null,
                                "SheetVID": null,
                                "cellcode": "{C_48.02, r*, c0030}",
                                "type": "m"
                            }
                        },

[dgm9704]

www.eba.europa.eu/eu/fr/xbrl/crr/fws/dora/4.0/tab/b_07.01/b_07.01.json

"columns": {
                "c0010": {
                    "eba:documentation": {
                        "KeyVariableID": "480197",
                        "KeyVariableVID": "480197",
                        "PropertyID": "1012401908",
                        "headerCode": "0010",
                        "headerDirection": "X",
                        "headerVID": "218885",
                        "type": "s"
                    }
                },
                "c0020": {
                    "eba:documentation": {
                        "KeyVariableID": "480199",
                        "KeyVariableVID": "480199",
                        "PropertyID": "1012401953",
                        "headerCode": "0020",
                        "headerDirection": "X",
                        "headerVID": "218886",
                        "type": "s"
                    }
                },
                "c0030": {
                    "dimensions": {
                        "concept": "eba_met_4.0:qNMX"
                    },
                    "eba:documentation": {
                        "AllowedValue": {
                            "eba_qCO:qx2000": 1012403418,
                            "eba_qCO:qx2001": 1012403419,
                            "eba_qCO:qx2002": 1012407803,
                            "eba_qCO:qx2003": 1012407804,
                            "eba_qCO:qx2004": 1012407805,
                            "eba_qCO:qx2005": 1012407806
                        },
                        "CellCode": "{B_07.01, r*, c0030}",
                        "CellID": 305883,
                        "ColumnVID": 236670,
                        "FactVariableID": 3296068,
                        "FactVariableVersionID": 3296068,
                        "RowVID": null,
                        "SheetVID": null,
                        "type": "e"
                    }
                },