Skip to content

fix: 修复构造过程文档中多处链接问题和格式问题 #1411

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

Open
wants to merge 2 commits into
base: Swift-6.1
Choose a base branch
from

Conversation

Intro1997
Copy link

此 PR 修复了 构造过程 的第三自然段结尾处关于析构过程文档的链接无法点击跳转的问题

@Intro1997
Copy link
Author

新增了三处问题的修复:

  1. 值类型的构造器代理 的继承链接问题
  2. 构造器的继承和重写 中,doc:类的构造器代理规则 应为 doc:类类型的构造器代理
  3. 重写一个可失败构造器用一个不可失败构造器 init?(name:) 应为 用一个不可失败构造器 init(name:)

@Intro1997 Intro1997 force-pushed the fix/link_error branch 2 times, most recently from 76be8ae to 598f22c Compare April 9, 2025 15:17
@Intro1997
Copy link
Author

Intro1997 commented Apr 18, 2025

新增修复,解决了以下问题

  1. 嵌套类型的第一自然段中:

    同样的,为了在更复杂类型的上下文中使用而定义纯工具性结构,以及通常与特定类型结合使用的协议,也显得十分便利。

    修改为

    同样的,为了在更复杂类型的上下文中使用而定义的纯工具性结构体,以及通常与特定类型结合使用的协议,也显得十分便利。

    原文为:

    Similarly, it can be convenient to define utility structures purely for use within the context of a more complex type, and protocols that are normally used in conjunction with a specific type.

    这里 structures 与 protocols 为并列关系,包括后文 To accomplish this, Swift enables you to define nested types, whereby you nest supporting types like enumerations, structures, and protocols within the definition of the type they support. 中,将 enumerations, structures, and protocols 并列列出,因此这里的 structures 翻译为 结构体 更合适。

  2. 非结构化并发 中关于 Task.initTask.detached 的引用因为定义距离 Task 链接后的 . 太近而导致失效。

  3. Actoractor 也是应用类型 应为 actor 也是引用类型

  4. 使用嵌套类型这里 链接错误。

  5. 扩展的语法这里 的链接错误

  6. 隐式解包可选类型这里 的链接错误

  7. 类型类型继承子句 段落缺少标题。

    本页所有关于语法的引用格式均不正确。

    另外 可选类型 标题重复出现

    段落 缺少标题 类型推断

    段落 缺少标题 函数类型

  8. 声明构造例如 中间缺少句号

    这里 简化 setter 声明 标题链接错误

    这里 两处链接错误

  9. 特性 中,这里 两处链接错误

发现但未确定可以修复的问题:

  1. 由于 Statements 文档中注释没有去掉,导致所有对 Statements 文档的引用均失效,看 commit 似乎 Statements 还处于未定稿状态。

@Intro1997
Copy link
Author

此 PR 后续应该不会再提交改动了,辛苦 review 一下

@Intro1997 Intro1997 changed the title fix: 修复构造过程文档中析构过程的链接问题 fix: 修复构造过程文档中多处链接问题和格式问题 Apr 19, 2025
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.

2 participants