Skip to content

Spelling#1278

Merged
tgreenx merged 94 commits into
zonemaster:developfrom
jsoref:spelling
Aug 20, 2024
Merged

Spelling#1278
tgreenx merged 94 commits into
zonemaster:developfrom
jsoref:spelling

Conversation

@jsoref

@jsoref jsoref commented Jun 26, 2024

Copy link
Copy Markdown
Contributor

Purpose

Fixes misspellings identified by the check-spelling action.

Context

The misspellings have been reported at https://github.com/jsoref/zonemaster/actions/runs/9671895030#summary-26683304529

Changes

...

How to test this PR

The action will report that the changes in this PR would make it mostly happy: https://github.com/jsoref/zonemaster/actions/runs/9671895135#summary-26683304887

Comment thread Changes
Comment thread Changes
[Zonemaster product]
- This version of Zonemaster also consists of the following components. For
each component, see its Changes file or Github release notes for complete
each component, see its Changes file or GitHub release notes for complete

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

brand

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Yes, a brand name. And depends on how much you should respect brand name camel case. In running text, should you write "iPhone" as Apple wants or "Iphone" which better conforms with normal writing? I tend to write "Github" and "Iphone". I think it is easier to read and write.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I find both jarring. But I can easily drop individual corrections (as I've already done), so I'm happy to drop them if that's desirable. I don't want perfection to be the enemy of incremental improvement.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I can see both views, and I do not have such a strong meaning. I'll ask the others in the team. Thanks for your engagement!

@matsduf

matsduf commented Jun 26, 2024

Copy link
Copy Markdown
Contributor

A lot of nice corrections. Changing the zone names and name server names for test zones have consequences beyond this repository. The corrections must be done in the develop branch.

@jsoref

jsoref commented Jun 26, 2024

Copy link
Copy Markdown
Contributor Author

I can change branches... probably won't do it until evening...

@jsoref

jsoref commented Jun 26, 2024

Copy link
Copy Markdown
Contributor Author

I could also split those changes out if that's more helpful

@jsoref jsoref force-pushed the spelling branch 2 times, most recently from 0e319d9 to 6ce43e4 Compare June 26, 2024 15:42
@jsoref

jsoref commented Jun 26, 2024

Copy link
Copy Markdown
Contributor Author

I've dropped sibling which was a zone change and have of example. I don't think there are any other things that change server names or zone content, but I was doing a quick skim.

@matsduf

matsduf commented Jun 26, 2024

Copy link
Copy Markdown
Contributor

I've dropped sibling which was a zone change and have of example. I don't think there are any other things that change server names or zone content, but I was doing a quick skim.

I saw no zone or name server names left. If they are to be change it should be in a separate PR coordinated with needed changes in Zonemaster-Engine.

@matsduf matsduf changed the base branch from master to develop July 8, 2024 13:41
@matsduf

matsduf commented Jul 8, 2024

Copy link
Copy Markdown
Contributor

I changed target branch to develop. Some updates in connection to the release have created conflicts. Can you handle those in the PR?

@jsoref

jsoref commented Jul 8, 2024

Copy link
Copy Markdown
Contributor Author

@matsduf: done

matsduf
matsduf previously approved these changes Jul 8, 2024

@marc-vanderwal marc-vanderwal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Well, thanks for this much-needed round of spell-checking!

I’m perfectly fine with this change, but there are a few little mistakes and omissions that need to be addressed before merging this PR.

Comment thread docs/internal/maintenance/Instructions-for-translators.md Outdated
Comment thread docs/internal/functional-tests/Configuration-TP/configuration02.md Outdated
Comment thread docs/public/specifications/tests/Zone-TP/zone09.md Outdated
Comment thread docs/public/specifications/tests/Zone-TP/zone01.md
Comment thread docs/internal/test-requirements/TestRequirements.md Outdated
Comment on lines +79 to +81
DS10_NAME_NOT_COVERED_BY_NSEC | ERROR | ns_ip_list | The nonexistent name is not correctly covered by the NSEC records.
DS10_NAME_NOT_COVERED_BY_NSEC3 | ERROR | ns_ip_list | The nonexistent name is not correctly covered by the NSEC3 records.
DS10_NON_EXISTENT_RESPONSE_ERROR | ERROR | ns_ip_list | No or error in response of an expected nonexistent name.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The messages in Zonemaster::Engine are different, but do erroneously spell non-existent as nonexistent.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I can drop, but my preference is to move both repositories to nonexistent. I can also move this to a different PR...

@matsduf matsduf Jul 9, 2024

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Wikipedia has nonexistent as main entry, but non-existent as an alternative.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

However, dictionary.com has no entry for “non-existent”; only “nonexistent”. I suggest we go ahead fixing the spelling mistake both here and in the msgid.

I was going to say that there is a discrepancy between the spec and the code in the messages, but the specification of DNSSEC10 merely states “Description of when message tag is outputted”. However, more recent specifications do have an exact copy of the msgids in that column. Shouldn’t we create an issue about that?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I do not think we need to create an issue because we know that we have old specifications that need an update (and @tolvmannen has started with the first in that list, Address01).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@marc-vanderwal, I think it would be wrong to consider "non-existent" to be an error just because dictionary.com is lacking it. My printed New World Dictionary states that "a hyphen may be used after non-". Both alternatives are as correct.

[Method5]: ../Methods.md#method-5-obtain-the-name-server-address-records-from-child
[NOTICE]: ../SeverityLevelDefinitions.md#notice
[Non-Existent Query Name]: #the-non-existent-query-name
[Non-Existent Query Name]: #the-nonexistent-query-name

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This change alone will break the link. In order to avoid that, the corresponding section header should also have its spelling fixed (see line 306) and the links in this document need to be updated accordingly.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Thanks. I think I've adjusted this properly.

jsoref added 13 commits July 9, 2024 09:21
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
jsoref added 21 commits July 9, 2024 22:55
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>

@marc-vanderwal marc-vanderwal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good to me!

@tgreenx tgreenx left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks for this !

@tgreenx tgreenx merged commit f2aa460 into zonemaster:develop Aug 20, 2024
@tgreenx tgreenx added this to the v2024.2 milestone Aug 20, 2024
@tgreenx tgreenx added the A-Documentation Area: Documentation only. label Aug 20, 2024
@jsoref jsoref deleted the spelling branch August 20, 2024 14:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Documentation Area: Documentation only.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants