Code Monkey home page Code Monkey logo

did-wg's Introduction

W3C Logo

Decentralized Identifier Working Group

This is the repository for the home page of the W3C DID Working Group:

https://www.w3.org/2019/did-wg/

(That URL is redirected to the w3c.github.io view of this repository.)

Specifications

GitHub repositories are linked from each specification. There is a separate list of repos of this WG.

Contributing to the DID Working Group Repositories

Use the standard fork, branch, and pull request workflow to propose changes to the specification. Please make branch names informative—by including the issue or bug number for example.

Editorial changes that improve the readability of the spec or correct spelling or grammatical mistakes are welcome.

Please read CONTRIBUTING.md, about licensing contributions.

DID Working Group Repositories

Meetings

See separate page for information on meetings.

Tools

Generating weekly minutes is done via the scribejs script and some additional configuration settings provided in this repo (see .scribejs.json).

To use this repository's scribejs setup first install the tools...

$ npm install

Then run the following (with date information changed to match your scenario):

$ npm run scribejs -- -d 2018-07-06 -o _minutes/2019-10-06-did-wg.md

This will request the IRC logs for the correct channel and convert them into the Kramdown (a more feature rich form of Markdown) with settings to match this repositories other documents.

If you need to make edits to the IRC log before generating the output (due to incorrect scribenick or similar), you can download the W3C logs from URLs such as https://www.w3.org/2019/10/06-did-wg-irc.txt. Once downloaded, you can reference that input document directly (rather than using the automatic date-based retrieval).

For example:

$ curl https://www.w3.org/2019/10/06-did-wg-irc.txt > 2019-10-06-did-irc.txt
$ npm run scribejs -- 2019-10-06-did-irc.txt -d 2019-10-06 -o _minutes/2019-10-06-did.md

Edit the .txt file and repeat the npm run scribejs line as necessary. Once finished, you can commit the .md file and delete the .txt file (or keep it for your records).

Alternatively, you can also use the browser interface to scribejs relying on your local clone of the WG's repository.

Jekyll

This site is built for Jekyll. If you have Jekyll and npm installed, you can run npm run serve to have Jekyll watch the working directory for changes and compile the templates (etc) incrementally.

Once run, you can browse the site at http://localhost:4000/2019/did-wg/ (the extra path information is required to match the w3.org hosting location).

did-wg's People

Contributors

brentzundel avatar burnburn avatar dependabot[bot] avatar gannan08 avatar iherman avatar msporny avatar pchampin avatar peacekeeper avatar tallted avatar xueyuanjia avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

did-wg's Issues

Add CODEOWNERS + Turn on branch protection

Block any merges when changes are requested.

Dismiss stale reviews (request re-reviews)...

make it clear when things are ready to merge, and when things are blocked... and by who they are blocked (so you can ask for feedback).

rename master branches

Summary

We should rename the branch master to main and use that going forward for our work.

From Problematic Terminology in Open-Source on master/slave terminology in software:

Use of this term is problematic. It references slavery to convey meaning about the relationship between two entities.

Removing this terminology from our workflow is a small gesture to include more people from marginalized groups in this project.

(I’m open to names other than main)

Technical Steps

  • create main branch from master
  • make main the default GitHub branch
  • modify github/central to use main for release notes reloading
  • redirect PRs to main in all did wg repos
  • move branch protections from master to main
  • modify docs to reference main instead of master
  • delete master branch to avoid confusion?

Feedback?

Formal objections need a separate response

In did-imp-guide pull/27 there is an attempt to address the formal objections with wording that cannot in detail meet the concerns of the objectors, and that - in its current vague disapproval of proof-of-work DID methods as shown by calling them out under special requirements - cannot gain consensus.

It is possible to meet some possible concerns of the formal objectors if more precisely answering the implicit accusation with details about a specific DID method.

As one of the authors of a DID method relying on proof-of-work, I'm volunteering to lead writing a response that other WG members may sign on to if they agree. This could end up as a WG Note, but if it's voted down then it will end up as a mailing list email.

In particular, I believe that along with practical reasoning, a causal model connecting the anchoring of DIDs on the Bitcoin blockchain to the alleged "fail" of the TAG/EWP sustainability goal will help all parties speak more intelligently about the issue.

Using this form of reasoning it is possible to examine the addition of each DID method anchoring transaction to the Bitcoin blockchain and quantify the additional motive to burn carbon-based fuels for electricity. This metric can be used to offset the carbon polluted into the atmosphere.

Two DID methods that will be discussed are did:btcr and did:ion. I will also critique conflicting TAG/EWP goals, discuss other moral concerns, point to transistions underway in the energy sector and speak about the economic incentives to use renewable energy, offer an example criteria to add to the Rubric so that end users can make later use of the reasoning, and offer to act as editor coordinating sections on other aspects of the formal objections, such as the request for a mandatory reference method.

Based on feedback so far, most people think that references to TAG/EWP in the Implementation Guide is enough. If that's the only response, then the concerns of the formal objectors will not be addressed directly.

Clarification of DID URL Path

From https://www.w3.org/TR/did-core/#path

A DID path is identical to a generic URI path and conforms to the path-abempty ABNF rule in RFC 3986, section 3.3. As with URIs, path semantics can be specified by DID Methods, which in turn might enable DID controllers to further specialize those semantics.

As far as I could tell, there are no DID methods that use these path semantics. Moreso, it is not clear from this description what these path semantics are envisioned to represent. A DID URL made by adding a query or fragment to a DID can be understood as acting on or referencing the metadata resolved from the DID. However, it is unclear if a URL made by appending a path to a DID has any particular relationship with the subject or the controller.

To put it a different way, I'm unclear what the resource is of a DID URL with a path - while a DID URL without a path is unambiguously referencing the subject as the resource.

If there are no semantics defined for it, why not leave path components reserved?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.