Skip to content

This issue was moved to a discussion.

You can continue the conversation there. Go to discussion →

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[inbox] Principles (new and old) #875

Closed
rufuspollock opened this issue Jun 12, 2020 · 4 comments
Closed

[inbox] Principles (new and old) #875

rufuspollock opened this issue Jun 12, 2020 · 4 comments

Comments

@rufuspollock
Copy link
Contributor

rufuspollock commented Jun 12, 2020

Reducing magic (june 2020)

Parsimony / Simplicty

  • Parsimony: => no name on resource
@rufuspollock rufuspollock changed the title [inbox] Rufus' Inbox [inbox] Principles (new and old) Jun 12, 2020
@roll
Copy link
Member

roll commented Jul 27, 2020

Is there a chance that we can reduce the number of properties' mixed types as we discussed previously e.g.

  • making schema.primaryKeys an array only
  • making schema.foreignKeys.[reference.]fields and array only
  • considering another notation for multipart resources as resource.path being string or array is a real pain to handle in software

I think most of the type mixing makes implementations struggle and, at the same time, I'm not sure whether it helps end-users or confuse them even more. E.g. if you see schema.primaryKey as a string in one example and them you see it as an array in another example, you will probably start thinking what the right one or out-dated or etc.

@roll
Copy link
Member

roll commented Jul 27, 2020

Just wanted to share another thinking. I'm wondering if currently, the specs are too fragmented which makes it hard to understand Frictionless Data conceptually.

I think in general we can have 4 core specs (+ numerous extra specs like FDP):

  • data package (not sure if tabular data package is needed at all after tabular data resource introduction)
  • data resource (I would merge data resource and tabular data resource making it one hierarchical spec)
  • table schema
  • table dialect / csv dialect (Frictionless Data Community Survey #697)

Also copying @lwinfree as we discussed earlier the specs understanding problem

PS.
Profiles (aka JSONSchema), in this case, will not be 1-to-1 to the specs, it will be 1-to-n. E.g. resource spec will have a few attached profiles (general/tabular).

@lwinfree
Copy link
Member

I definitely agree that it is confusing right now. From a technical decision, I'm not sure what is best, but I think either way, we should work to better document the distinction between the various specs to help remove that confusion.

@roll roll transferred this issue from frictionlessdata/specs Jan 3, 2024
@frictionlessdata frictionlessdata locked and limited conversation to collaborators Jan 3, 2024
@roll roll converted this issue into discussion #876 Jan 3, 2024

This issue was moved to a discussion.

You can continue the conversation there. Go to discussion →

Labels
None yet
Projects
Status: Done
Development

No branches or pull requests

3 participants