From 6283ad6936783852122ba59121afd5a0e88b3136 Mon Sep 17 00:00:00 2001 From: "chen.ma" Date: Thu, 15 Sep 2022 08:23:06 +0800 Subject: [PATCH] Change official documentation --- docs/docs/{community => user_docs/other}/question.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) rename docs/docs/{community => user_docs/other}/question.md (99%) diff --git a/docs/docs/community/question.md b/docs/docs/user_docs/other/question.md similarity index 99% rename from docs/docs/community/question.md rename to docs/docs/user_docs/other/question.md index ff899b5a..340bedc7 100644 --- a/docs/docs/community/question.md +++ b/docs/docs/user_docs/other/question.md @@ -1,10 +1,10 @@ --- -sidebar_position: 5 +sidebar_position: 3 --- # 问题提问 -文档引用自:[提問的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way) +文档引用自:[提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way) ## 在提问之前 @@ -33,11 +33,11 @@ sidebar_position: 5 因此,第一步是找到对的论坛。再说一次,Google 和其它搜索引擎还是你的朋友,用它们来找到与你遭遇到困难的软硬件问题最相关的网站。通常那儿都有常见问题(FAQ)、邮件列表及相关说明文件的链接。如果你的努力(包括**阅读** FAQ)都没有结果,网站上也许还有报告 Bug(Bug-reporting)的流程或链接,如果是这样,链过去看看。 ### 使用有意义且描述明确的标题 + 在邮件列表、新闻群组或论坛中,大约 50 字以内的标题是抓住资深专家注意力的好机会。别用喋喋不休的帮帮忙、跪求、急(更别说救命啊!!!!这样让人反感的话,用这种标题会被条件反射式地忽略)来浪费这个机会。不要妄想用你的痛苦程度来打动我们,而应该是在这点空间中使用极简单扼要的描述方式来提出问题。 一个好标题范例是`目标 —— 差异`式的描述,许多技术支持组织就是这样做的。在`目标`部分指出是哪一个或哪一组东西有问题,在`差异`部分则描述与期望的行为不一致的地方。 - > 蠢问题:救命啊!我的笔记本电脑不能正常显示了! > 聪明问题:X.org 6.8.1 的鼠标指针会变形,某牌显卡 MV1005 芯片组。 @@ -215,7 +215,6 @@ sidebar_position: 5 最后,我将透过举一些例子,来说明怎样聪明的提问;同一个问题的两种问法被放在一起,一种是愚蠢的,另一种才是明智的。 - **蠢问题**: > 我从 foo 项目找来的源码没法编译。它怎么这么烂? @@ -228,7 +227,6 @@ sidebar_position: 5 提问者已经指明了环境,也读过了 FAQ,还列出了错误,并且他没有把问题的责任推到别人头上,他的问题值得被关注。 - **蠢问题**: > 我的主机板有问题了,谁来帮我?