frictionlessdata / datapackage-fiscal

Fiscal Data Package is a lightweight and user-oriented format for publishing and consuming fiscal data. Fiscal data packages are made of simple and universal components. They can be produced from ordinary spreadsheet software and used in any environment.

https://fiscal.datapackage.org/

The Unlicense

2 stars 0 forks source link

Readable and actionable Fiscal Data Package documentation #4

Open pwalsh opened 7 years ago

pwalsh commented 7 years ago

Description

Who is the audience for the spec? Ensure the spec text speaks to them.

See here and here for more context.

Tasks

[ ] Present draft structure for review
[ ] Present draft text for review
[ ] Ship for v1-rc1

Vanuan commented 7 years ago

Old discussion is unavailable

stevage commented 7 years ago

Personally, I think the main audience for the specs is anyone who will be generating conformant files. If you're just creating one or two files, you'll use the data packager. But if you need to generate files on the fly, then you need it.

Btw, having just revisited some of this stuff for the first time in a while, I found it surprisingly confusing and difficult dealing with all the different layers of spec. FDP, Table Schema, Tabular Data Resource, Data Package. Probably this would be improved by further iterations of reducing verbage, linking to the right place at the right time, etc - but maybe some bigger reorganisation required too.

pwalsh commented 6 years ago

@akariv

Can you link to the current text working document of the v1 spec in whole, which, while still in need of editing and structure, takes a completely different approach to the v0.3 spec and is much more friendly and readable. Would be good to get some feedback even in current state.

akariv commented 6 years ago

This is the current working draft of the spec: https://hackmd.io/BwNgpgrCDGDsBMBaAhtALARkWsPEE5posR8RxgAzffWfDIA=?view

All feedback would be most welcome!