search

okfn / data-catalog-spec

Data Catalog Specification (Schema and Protocol)
http://spec.datacatalogs.org/
20 stars 4 forks source link

Provide human-readable version(s) of this "spec" #2

Open olyerickson opened 12 years ago

olyerickson commented 12 years ago

An executable "spec" is very clever, but is not what the user expects when following a link such as "Check out our spec!"

Please provide at least PDF version of the most recent versions, and/or a README to the uninitiated as to what they are landing on/in when they arrive here.

Especially if you plan to publicize this far and wide, as you are...

Thanks!

band commented 12 years ago

I agree with John Erickson re providing human readable versions of the spec or some documentation about how such a document is produced.

That said, providing source code for the spec is a good idea.

Cheers.

rufuspollock commented 12 years ago

@olyerickson just to clarify is that regarding this source repo or http://spec.datacatalogs.org/ - the latter is what most people should be looking at. You only look at the "source" text in this repo if you want to modify.