Clarify DataPackage File Info Section

[trestletech]

I'm unclear on the File Info Section on the Data Package documentation. Specifically:

1. Is a name/ID not a required/suggested attributed for a file? Foreign Key attribute in JSON schema #23 seems to imply that this information would be required for each file. Of course, if files were a hash, each file element could be named explicitly in a pretty natural way. Currently, it's listed as an array.
2. What combination of data is expected/required? Would one use the schema key be used only if the file were in the JSON Table Schema, while the dialect key would be used for CSVs? Or should they both always be supplied?

I'm working on the ability to retrieve data files from a specified Data Package JSON file in the R client and need to figure these two things out in order to proceed.

[trestletech]

Alternatively, perhaps the ID/Name should be specified within each JSON Table Schema?

[rufuspollock]

@trestletech good questions.

1. On name/id i've booted a dedicated issue Files should have a required name (or id) attribute #32
2. Requirements: only one of url or path is strictly necessary at the moment. If you do have a CSV file then the schema should be there (and dialect should be present if not defaults). So I think you can proceed on the basis that for data package you would handle schema will always be there.

[trestletech]

Great. If we can get my pull request merged, I'd be happy to create another one to clarify the docs on this.

[rufuspollock]

@trestletech you may actually also want to look at http://www.dataprotocols.org/en/latest/simple-data-format.html which builds on data packages and json table schema adding additional requirements and restrictions. To be clear:

• A Simple Data Format dataset IS A data package
• Simple Data Format USES data package spec and json table schema spec