Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New section on environmental impacts #27

Merged
merged 53 commits into from
Nov 4, 2021
Merged
Changes from 52 commits
Commits
Show all changes
53 commits
Select commit Hold shift + click to select a range
850d182
chore: new section on envrionmental impacts
mprorock Sep 2, 2021
c7355c9
correct spelling
mprorock Sep 2, 2021
7e4093e
correct spelling
mprorock Sep 2, 2021
eb86210
spelling
mprorock Sep 2, 2021
7561e14
spelling
mprorock Sep 2, 2021
29e2d39
chore: updates to include explicit refs to the Ethic web principles
mprorock Sep 3, 2021
b508dbb
chore: update some language around proof of work
mprorock Sep 3, 2021
c961d1f
chore: clean up formating and order of section 7
mprorock Sep 3, 2021
cbb379b
Update index.html to correct spelling and spacing
mprorock Sep 3, 2021
78abe49
chore: update language to remove specifics around proof of work that …
mprorock Sep 3, 2021
a1e9ee4
chore: further language updates
mprorock Sep 3, 2021
1e8fce6
chore: spelling error
mprorock Sep 3, 2021
2fb6306
chore: removed unecessary reference to a ledger approach
mprorock Sep 3, 2021
5fe1f17
language improvement
mprorock Sep 3, 2021
3064e2f
language improvement
mprorock Sep 3, 2021
d65ed98
language improvement
mprorock Sep 3, 2021
4820791
formatting
mprorock Sep 3, 2021
b13b97a
language clarifications
mprorock Sep 3, 2021
22c6943
grammar
mprorock Sep 3, 2021
90d6e16
chore: update and add some clarifying language
mprorock Sep 7, 2021
e4b620c
chore: some minor language mods
mprorock Sep 7, 2021
a0a3a10
Revert "chore: some minor language mods"
mprorock Sep 7, 2021
0fa5901
Revert "chore: update and add some clarifying language"
mprorock Sep 7, 2021
6c798be
Update language around appropriate use of tech
mprorock Sep 9, 2021
93870c3
language improvement
mprorock Sep 14, 2021
02317a8
language improvement
mprorock Sep 14, 2021
5528479
chore: add text to reflect that new section is view of some mebergs o…
mprorock Sep 14, 2021
f578a20
chore: cleanup
mprorock Sep 14, 2021
23a2273
Merge branch 'feature/environmental' of github.com:mesur-io/did-imp-g…
mprorock Sep 14, 2021
989686b
chore: update structure to group items in env section related to view…
mprorock Sep 14, 2021
3839b6c
chore: spelling fix
mprorock Sep 14, 2021
1174832
language clarifications
mprorock Sep 14, 2021
6f51ec9
language improvement
mprorock Sep 15, 2021
06a563a
language improvement
mprorock Sep 15, 2021
67b5c83
spelling
mprorock Sep 15, 2021
9053df0
chore: pull two use cases to PR over to use case doc
mprorock Sep 15, 2021
a476381
Merge branch 'feature/environmental' of github.com:mesur-io/did-imp-g…
mprorock Sep 15, 2021
b0d199f
clarify wording
mprorock Sep 15, 2021
34b7d3a
chore: remove non-normative language based on repeated objections fro…
mprorock Sep 16, 2021
f5b3c95
Update index.html
mprorock Sep 16, 2021
6bf9c01
Update index.html
mprorock Sep 16, 2021
2ee868d
language improvement
mprorock Sep 16, 2021
2d82297
tag formatting
mprorock Sep 16, 2021
1310b0c
language improvement for clarity
mprorock Sep 20, 2021
2e296c1
Improved language
mprorock Sep 21, 2021
35e8147
Improved language
mprorock Sep 21, 2021
171176c
Update to section heading in response to comment from ChristopherA
mprorock Sep 22, 2021
bfe1e39
chore: adjust section and subsection headers
mprorock Sep 22, 2021
961c3cf
chore: update language in section headings
mprorock Sep 22, 2021
e046d08
chore: update to remove section on potential trade offs based on use …
mprorock Sep 22, 2021
b2f7768
update to correct grammar and clarify
mprorock Sep 22, 2021
4e2b768
add clear language related to additional use of existing infrastructure
mprorock Sep 28, 2021
eee9e0c
chore: remove link to PR against rubric to add environmental criteria
mprorock Oct 19, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 93 additions & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1412,6 +1412,99 @@ <h3>Biometrics</h3>
</section>
</section>

<section class="informative">
<h2>Ethical Considerations</h2>

<p>
The following section details certain key areas of focus when implementing a
new DID method, or implementing a solution that incorporates DIDs.
</p>

<p>
The <a
href="https://www.w3.org/2001/tag/doc/ethical-web-principles/">W3C TAG
Ethical Web Principles</a> document is a helpful guide
when weighing ethical considerations of various technologies.
</p>

<section class="informative">
<h3>Broad Ethical Principles</h3>
<p>
Decentralized Identifiers may come to underpin much of our digital life. This
may include public social and career personas, as well as more private personas
shared among friends and family. Identifiers representing these personas and
relationships may be some of the most important in our lives, so great care
will be taken when choosing an identifier system to support these critical
activities. As with all things, the appropriate and ethical use of technology
will be strongly considered when implementing items related to DIDs.
</p>

<p>
As noted in the <a
href="https://www.w3.org/2001/tag/doc/ethical-web-principles/#principles">
Principles</a> section of the Ethical Web Principles, there are key goals that
apply to all Web standards and technologies. DIDs are explicitly intended to
help users get closer to several of these goals, especially the following:
<ul>
<li>
<a href="https://www.w3.org/2001/tag/doc/ethical-web-principles/#privacy">
Privacy
</a>
</li>
<li>
<a href="https://www.w3.org/2001/tag/doc/ethical-web-principles/#control">
Individual Control
</a>
</li>
<li>
<a href="https://www.w3.org/2001/tag/doc/ethical-web-principles/#multi">
Device Independence
</a>
</li>
</ul>
</p>
</section>

<section class="informative">
<h3>Other concerns as applied to DID method development</h3>
<p class="advisement">
The following section reflects the views of some members of the working group.
Additional PRs are welcome from the working group with additional points of view.
</p>

<section class="informative">
<h3>Environmental Considerations</h3>

<p>
The guiding principle that
<a href="https://www.w3.org/2001/tag/doc/ethical-web-principles/#sustainable">the
web must be an environmentally sustainable platform</a> should be followed.
<br />
When implementing or utilizing a DID method, consideration should be given
to the environmental impacts caused by the method.
</p>

<p class="issue">
Some members of the working group feel it important that the [[DID-RUBRIC]]
include environmental considerations as discussed in <a
href="https://github.com/w3c/did-rubric/pull/51">this pull request</a> in
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I doubt it is appropriate to cite a PR to another document within the implementation guide.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's pretty common to cite issues or PRs when work is in progress, as a way on unblocking work. We've done this a few times in did core if you prefer to cite an issue instead of the PR, we can make that change.... for example:

https://github.com/w3c/did-spec-registries/blob/main/index.html#L1061

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd agree if we were earlier in the publication process, but this is now a published note, so its not really a "work in progress" as much as, say, the current VC-API spec.

Seems to me, if we want to point to specifics in the Rubric, we should point to published criteria, and if necessary, keep issues open in the implementation guide repo until we get good criteria added to the Rubric.

Copy link
Contributor

@OR13 OR13 Sep 28, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

my point is that its bad form to object to adding a link to an open issue / PR, as a mechanism for making progress on a contentious issue... we make progress incrementally, sometimes that acknowledges that issues remain open... For example:

w3ctag/design-principles#338
https://github.com/w3ctag/design-principles/issues/339
w3ctag/design-principles#239

Could all be cited since they are all relevant to the imp guide, and all remain unresolved.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@OR13 any issue in pulling the PR reference as this issue paragraph will go away soon enough with just a pointer to the rubric?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't have any issues merging PRs... git tracks the history of all changes and all comments.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jandrieu -- The published NOTE is a static document, which does not and will not include the reference to the PR on another document. There's nothing wrong with such a reference in an Editor's Draft, on one of which all these current PRs are focused, and from which all such references would be removed before it were published as an updated NOTE.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@TallTed As I understand it, echidna now automatically publishes updates to the document. So, all PRs merged get published.

In short, I don't believe this is an editor's draft any longer.

Maybe @iherman can correct me if I'm wrong.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This remains unresolved. IMO, a published W3C doc should not point a pull request.

order that users might appropriately evaluate and compare relevant aspects
of DID methods that might be applicable to their use cases.
</p>
<p>Many methods minimize environmental impact by leveraging existing infrastructure, such as
the World Wide Web (with did:web) and Bitcoin (with did:btcr and did:ion). When considering any
particular approach, whether creating a new method or selecting among current methods, care
should be taken to distinguish between the marginal impact of the additional use of such
infrastructure as a result of the DID method and the existing impact from current use. For example,
the did:web implementation is unlikely to have a significant additive environmental impact above
and beyond the existing World Wide Web.
</p>
</section>
mprorock marked this conversation as resolved.
Show resolved Hide resolved

</section>

</section>

<section>
<h2>Future Work</h2>
<p class="note">
Expand Down