技巧 #1:所有导师都应该知道什么





5.00/5 (16投票s)
处理首次作者的一般方法
引言
在与初次投稿的作者打交道时,有些事情应该做,有些事情不应该做。最重要的是要记住,您希望帮助他们成为更好的作者。表示尊重
从定义上来说,初次投稿的作者在 CodeProject 文章格式以及如何与 CodeProject 社区互动方面,尤其是如何处理成员们直言不讳的评论方面,并不了解一切。在大多数情况下,您的工作是告诉他们:“看看这个,你应该这样做。”作者没有经验,并不意味着他愚蠢。他只是缺乏知识,您可以告诉他他需要知道什么,但要以礼貌、积极的方式。错误做法的例子:
把这堆狗屎从网站上拿下去,直到你学会如何正确格式化。
正确做法的例子:
您的文章看起来可能非常有帮助。只需做一些格式上的修改,它就会看起来更好,也更容易阅读。
关键点是:要有礼貌,要积极。
写下一些建议后,花点时间读一遍,想想如果您收到这些建议会作何感想。批评与负面评论之间只有一线之隔,您不希望发生的是作者认为您在侮辱他,或者居高临下。
如何成为一名出色的作家
我不知道如何做到这一点;我不认为有人知道。我知道的是如何写一篇易于阅读的文章,并让其他成员愿意阅读它。写就好像你在和另一位程序员说话一样。
这很简单。当你和另一位程序员说话时,你会说:
“我有一个关于提高性能的想法,所以我写了这个代码,然后我尝试了这个测试,然后我……”
你不必花言巧语,你只需要把事情说清楚。
- 解释你是如何产生这个想法的,你试图解决什么问题。
- 展示一些代码片段,解释它们的作用。
- 解释你是如何处理这个问题的。哪些网站帮助了你?你使用了哪些参考资料?
- 解释你是如何设计和组织代码的。
- 如果可能,附带一个演示应用程序。每个人都喜欢看截图。
- 别忘了告诉读者如何在自己的应用程序中使用这段代码。
不一定要完美
您对新作者的建议应该帮助他们一点一点地改进他们的文章。这是一个渐进的过程;除非您帮他们重写整篇文章,否则您必须先从一些基本的东西开始谈起,比如文章格式。许多初次投稿的作者并不熟悉 HTML,也从未使用过 UL、OL 或 LI HTML 标签。您可能会看到作者试图自己创建项目符号列表,这些列表看起来很糟糕,而且通常比使用标准的 HTML 列表标签要麻烦得多。如果您正在决定要告诉作者什么,这是一个很好的起点。同样,在沟通方面也有正确和错误的方式。错误做法的例子:这是个玩笑吗?你当时在想什么?看起来很糟糕。
正确做法的例子:
使用一些标准的 HTML 标签,您将节省大量工作,而且看起来会更好,也更容易阅读。让我举个例子……
关键点是:要有礼貌,要积极。
您不想通过告诉作者他有很多工作要做来吓跑他。您应该做的是专注于,比如说,最关键的 5 个问题,让作者能够以一种易于阅读且对其他成员有用的方式来呈现他的想法和代码。
请记住,CodeProject 上有很多非常好的文章,这并不意味着作者仔细看过它们;他可能和你一样忙。所以,另一件简单而明显的事情是告诉作者:“看看这篇文章,你应该这样做。”
处理成员
作者迟早会向您抱怨某个成员的评论。评论可能是合理的,也可能不合理;这并不重要。重要的是,这让作者感到自己被严厉对待、疲惫不堪。总的来说,您可能无法对评论做任何事情,除非涉及到某种 bug 报告,在这种情况下,您应该解释作者需要做什么来修复 bug 并重新发布他的文章。作者在 CodeProject 上需要适应的最难的事情之一是帖子的语气,正如您所知,这些帖子可能直言不讳、尖刻、侮辱性,或者这三者兼有。您对此无能为力,作者也无能为力;他越早学会他会遇到这些情况,就越好。您应该告诉作者的是,永远不要以牙还牙。他可能会获得短暂的满足感,但却冒着将文章论坛变成泥潭的风险。告诉作者,这些帖子会发生;没有人能阻止它们被发布;他应该礼貌地回复所有帖子;如果他无法礼貌地回复,最好不要回复。
最后,告诉作者,如果帖子特别恶劣、带有威胁性或种族主义,他可以在建议论坛中提出请求,网站管理员会处理。
处理负面帖子
好的,有人在作者崭新闪亮的文章上发表了粗鲁、负面的评论。相信我,我知道这种感觉,我收到过不少。它们都传递着相同的信息,即使措辞不同:我不喜欢这篇文章。你什么都不懂。我给它打 1 分。
除非发帖者只是一个 troll,否则我至少会尝试找出他为什么不满。我写了类似的话:
很抱歉您不喜欢这篇文章。您能告诉我您为什么不喜欢它吗?如果您能提供一些细节,我将尝试修复任何问题。
大多数时候,这会产生奇效。发帖者对我的意见感兴趣感到惊讶,这就是他一开始没有费心解释的原因。现在他提供了一些细节,我用这些细节来修复问题,或者更好地解释事情。此外,他甚至可能给文章打更高的分数。
处理低评分
这个问题对新作者来说也是一个棘手的问题。您必须强调长远来看;随着时间的推移,人们会发现这篇文章很有用,并会给它更高的评分。短期来看,文章正在被那些不一定立即需要它们的人阅读,而他们会相应地给文章评分。您需要告诉作者,随着时间的推移,他们的文章会随着经验的增长而改进。他们可以在学习更多知识的同时修改文章,文章论坛上的帖子将帮助他们看到如何改进文章。作者应该把每个帖子——即使是负面的——都视为改进文章的机会。您还可以建议作者阅读其他文章论坛上的帖子,看看他可能会收到什么样的评论。
结论
考虑到他们收到的评论类型,一些初次投稿的作者很难理解他们为什么还要费心。在我给出一些建议后,我最喜欢告诉作者的最后一句话是:我希望您能继续改进这篇文章。
被问到总是令人高兴的。