Rewrite intro, reorganize text in discovery section #87
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
csarven
reviewed
Feb 21, 2023
index.html
Outdated
Comment on lines
1126
to
1128
| The discovery process starts with the WebID, a URI that points | ||
| to exactly one document, referred to here as a WebID Profile | ||
| Document. This document can be expected to contain pointers to a |
There was a problem hiding this comment.
Suggested change
| The discovery process starts with the WebID, a URI that points | |
| to exactly one document, referred to here as a WebID Profile | |
| Document. This document can be expected to contain pointers to a | |
| The discovery process starts with the WebID, a URI that points | |
| to exactly one document, referred to here as a WebID Profile | |
| Document [<cite><a class="bibref" href="#bib-webid">WEBID</a></cite>]. This document can be expected to contain pointers to a |
And update similarly if need to be clear.
csarven
reviewed
Feb 21, 2023
index.html
Outdated
| The discovery process starts with the WebID, a URI that points | ||
| to exactly one document, referred to here as a WebID Profile | ||
| Document. This document can be expected to contain pointers to a | ||
| Preferences File Document containing settings & resources |
There was a problem hiding this comment.
Suggested change
| Preferences File Document containing settings & resources | |
| Preferences File Document containing settings and resources |
Also either <em> or <a> to Preferences File Document if there is something identifiable in this document.
csarven
reviewed
Feb 21, 2023
index.html
Outdated
Comment on lines
1130
to
1132
| meant only for the WebID owner, Type Index Documents containing | ||
| links to specific types of resources, and might also contain | ||
| Extended Profile Documents containing additional information |
There was a problem hiding this comment.
Same as earlier.. emphasise or link.
csarven
approved these changes
Feb 21, 2023
There was a problem hiding this comment.
Let's make sure now to lose comments / use cases like in the mix of closing issues when merging, e.g., #55 (comment) , and that the specification is able to provide a solution for it.
TallTed
reviewed
Feb 21, 2023
index.html
Outdated
Comment on lines
869
to
870
| <li>Factors specific to physical, physiological, genetic, mental, economic, cultural, social, or behavioural identity. | ||
| </li> |
There was a problem hiding this comment.
Suggested change
| <li>Factors specific to physical, physiological, genetic, mental, economic, cultural, social, or behavioural identity. | |
| </li> | |
| <li>Factors specific to physical, physiological, genetic, mental, economic, cultural, social, or behavioural identity.</li> |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR is a rewrite of the introduction.
Content about discovery has been moved to the discovery section (also to be revised soon).
Closes #52
Partially addresses #55
Preview | Diff