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

Link a design principle. #4

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Link a design principle. #4

wants to merge 1 commit into from

Conversation

jyasskin
Copy link

@jyasskin jyasskin commented Jan 23, 2024

Copy link

@tantek tantek left a comment

Choose a reason for hiding this comment

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

As much as I dislike Markdown, since the document already uses Markdown links for such links, it's probably better to keep code stylistic consistency accordingly, e.g. from further down in the document:

[one web](https://www.w3.org/TR/ethical-web-principles/#oneweb)

Other than that, this seems useful to link explicitly.

@jyasskin
Copy link
Author

I did that first, but then I realized that Markdown links don't trigger Respec's support for references. It seems better to generate the https://pr-preview.s3.amazonaws.com/jyasskin/the-web-is-not-versioned/pull/4.html#references, and maybe the other links should get updated to also be real references.

Copy link

@tantek tantek left a comment

Choose a reason for hiding this comment

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

That's interesting about Respect generating references in one case but not the other. Agreed. Looks good.

Would prefer to see an update of the other links deserving of explicit listing in references at the same time as this PR, but feel free to file a separate PR for that.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants