solid / solid/solidproject.org

Incorporate Kjetil's feedback on the vocab tutorial

Open
#163 0 comments 0 reactions 1 assignee View on GitHub

@NSeydoux is already working on this.

Since Mar 9, 2020.

Content user feedback
Dominant language
HTML
Stars
183
Forks
152
PR merge metrics
No merged PRs in 30d

Description

@kjetilk left a number of helpful comments on the vocab tutorial that we might want to consider integrating.

Great example, but I think it should mention that there tons of vocabs, and that in most cases, you'd just use somebody else's rather than create your own, it is even considered best practice.

https://github.com/solid/solidproject.org/pull/160/files/5944e3c119a87a06bc34140852a8afe86aa567c8#r389775722

I think it would be better to use Turtle's short a than rdf:type, even though it is a syntax specific thing.

https://github.com/solid/solidproject.org/pull/160/files/5944e3c119a87a06bc34140852a8afe86aa567c8#r389774386

One of my things is "Don't use hyphens, use underscores instead, because it simplifies using them in some programming languages." :-)

https://github.com/solid/solidproject.org/pull/160/files/5944e3c119a87a06bc34140852a8afe86aa567c8#r389778166

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.