Getting started

[pwalsh]

Description

This issue documents the initial steps to get started with a new Frictionless Data implementation.

Tasks

• Travis configuration
• Coveralls configuration
• Basic setup of README with badges
• Basic setup of license
• Review the whole family of specifications
• Review the implementation notes
• Review either the Python (Data Package Table Schema) or JavaScript (Data Package Table Schema) reference implementations (whichever language you feel most comfortable reading)
  • Note that we have high nineties test coverage on these libraries. Similar test coverage is expected here
• Review the stack reference
• Review the blog post that announces v1 of the specifications
• Review the test packages that can be used to test your work (in addition to the normal and expected unit tests)
• Review the OKFN Coding Standards
  • Parts of the coding standard are language specific, and parts are workflow specific. The workflow points are important for you. If you want to contribute language-related standards to our docs for your language, we welcome it!
• Write a set of high-level issues for each library, on the respective issue tracker, that outline the work plan
  • Note the structure of this issue: A narrative description and a specific list of tasks. Follow a similar pattern
  • The sequence of work is important: start with the Table Schema library first, as the Data Package library has a direct dependency on it
• Note the communication protocol for this work: All communication around the implementation must be in public. We want our work dynamic here to serve as an example for other implementors, and to share as much information as possible. There are two channels of communication:
  • GitHub Issues on tableschema-{LANG} and datapackage-{LANG}
  • Gitter chat at https://gitter.im/frictionlessdata/chat where all the core team at OKI are available for assistance
• Note the staff from OKI who are here to support you:
  • Jo Barratt - Project Manager for Frictionless Data
  • Evgeny Karev - Tech Lead for core Frictionless Data libraries
  • Serah Rono - Developer Advocate at Open Knowledge International, Dissemination Lead for the Tool Fund
  • Dan Fowler - Developer Advocate at Open Knowledge International, Pilot Lead for Frictionless Data, OKI Labs Lead
  • Adam Kariv - Engineering Lead at Open Knowledge International, Tech Lead on OpenSpending
  • Paul Walsh - Chief Product Officer at Open Knowledge International
• Any communication around the grant agreement should be directly done by email with Jo Barratt, Frictionless Data Project Manager