golang/go

net: better docs for PreferGo in Resolver

Open

#35,561 创建于 2019年11月13日

在 GitHub 查看
 (8 评论) (0 反应) (0 负责人)Go (19,008 fork)batch import
DocumentationNeedsInvestigationhelp wanted

仓库指标

Star
 (133,883 star)
PR 合并指标
 (30 天内没有已合并 PR)

描述

Guys, how are you?

I have a suggestion to improve doc about parameter PreferGo on struct Resolver based on a comment in another issue. https://github.com/golang/go/issues/19268#issuecomment-345384876

Suggestion adds more a small text:

When you use the variable PreferGo set to true you will be 
able to use your dial, If you use PreferGo set to false it will ignore 
your dial and use directly "/etc/resolv.conf "

Reference Doc: https://github.com/golang/go/blob/a38a917aee626a9b9d5ce2b93964f586bf759ea0/src/net/lookup.go#L120

贡献者指南

研究方向
查看 src/net/lookup.go:120 处 PreferGo 的现有文档以及问题 #19268 评论中的上下文，然后编写简洁准确的文档改进，说明 PreferGo 何时影响拨号行为。
技术栈
go
领域
backend
议题类型
文档
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
1
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1 小时以内
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
活跃
清晰度议题是否清楚说明期望改动、验收标准和下一步。
清晰
前置要求
Go
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
90