search

semantalytics / awesome-semantic-web

A curated list of various semantic web and linked data resources.
Creative Commons Zero v1.0 Universal
1.35k stars 237 forks source link

contributing.md #54

Open maximveksler opened 5 years ago

maximveksler commented 5 years ago

We need a contributing.md.

Maxims-MacBook-Pro:awesome-semantic-web maximveksler$ awesome-lint
✖ Linting

  README.md:2:25
  ✖    1:1   Missing file contributing.md                            awesome/contributing

We also need it because recently several discussions consider the bar of what goes into the list, I.e. what is the bar for including.

References:

  1. https://github.com/semantalytics/awesome-semantic-web/issues/52#issuecomment-442229991
  2. https://github.com/semantalytics/awesome-semantic-web/pull/50#issuecomment-442193577
  3. https://github.com/semantalytics/awesome-semantic-web/issues/46#issuecomment-441766226
  4. https://github.com/semantalytics/awesome-semantic-web/issues/38

This issue should be used to document references to existing contributing guide and the outcome should be consensus that will be published to be used for reference point of content including and pull requests feedback.

zacharywhitley commented 5 years ago

I think we should aim for being comprehensive yet concise. If there is a project that hasn't been maintained for a while but that covers a use case that has no alternatives I would say that it should be included. If there is an obviously a superior project that would would make it unlikely that the unmaintained project would ever be used I would not include it the list.

The one exception that I would make is the database section. There are a lot of ways to approach the design of triple stores and I think a historic perspective of what has been done is valuable.