正如您可能已經(jīng)知道，自2014一月以來(lái)我一直致力于為SitePoint作為他們的一個(gè)責(zé)任編輯，主要是編輯HTML，CSS，和非內(nèi)容。我也幫著移動(dòng)內(nèi)容，javascript，一些通用的網(wǎng)站的東西（Git的文章，構(gòu)建工具，和其他通用的內(nèi)容），我寫(xiě)的主要通訊SitePoint的每星期。

我愛(ài)我的工作在SitePoint的這是我曾經(jīng)最好的工作了。只要SitePoint仍然希望我為他們工作，我希望我能繼續(xù)幫助他們把內(nèi)容更好的前端開(kāi)發(fā)人員。

自從我開(kāi)始編輯工作以來(lái)，我已經(jīng)拒絕或發(fā)送一些編輯文章了。許多人拒絕遭受同樣的問(wèn)題。所以對(duì)于這篇文章，我把我的想法放在我認(rèn)為對(duì)一個(gè)好的網(wǎng)頁(yè)開(kāi)發(fā)文章或教程。

一些開(kāi)場(chǎng)白

在進(jìn)入這之前，讓我們從中得到一些東西：

不是每個(gè)人都會(huì)同意我的觀點(diǎn)。

我不寫(xiě)這篇文章，因?yàn)槲矣X(jué)得我比別人好。我們都有自己的優(yōu)勢(shì)。我不完美。我可以說(shuō)出100個(gè)比我好的開(kāi)發(fā)者/作家。

許多在這個(gè)崗位的項(xiàng)目是從一個(gè)文件我已經(jīng)有一段時(shí)間了，我已經(jīng)通過(guò)了編譯，對(duì)作家SitePoint，幫助他們提高。

這些技巧中的許多適用于任何類(lèi)型的寫(xiě)作，不僅是技術(shù)或發(fā)展。

我的觀點(diǎn)在這篇文章中不一定代表那些SitePoint或其管理。在SitePoint的編輯有很多自由塑造的內(nèi)容，但它仍然受制于SitePoint的指引，這可能與我自己在這里說(shuō)。

有了，有點(diǎn)拖了出來(lái)（更晚了！），讓我們到主要觀點(diǎn)。

添加支持語(yǔ)句的鏈接

文章幾乎總是有參考鏈接。如果你寫(xiě)的是前端技術(shù)，你的內(nèi)容應(yīng)該慷慨地連接到類(lèi)似的東西：

W3C規(guī)范

MDN的參考

權(quán)威文章受到尊敬的社會(huì)成員

好的文章由同一出版商，你寫(xiě)的（最好是不老的）。

如果你對(duì)一個(gè)特定的工具或技術(shù)（如特定的jQuery插件或CSS預(yù)處理器），你的第一段應(yīng)該鏈接到首頁(yè)，技術(shù)。如果你是在談?wù)撘粋€(gè)新的工具或技術(shù)或者一個(gè)不是眾所周知的。在某些情況下，如果工具是常見(jiàn)的上下文（如在博客上關(guān)于SASS Sass），那么你可能是罰款不包括一個(gè)鏈接到SASS的主頁(yè)。

你還應(yīng)該包括鏈接，以支持某些類(lèi)型的報(bào)表。例如：

“谷歌認(rèn)為搜索引擎優(yōu)化排名的頁(yè)面速度。”

“研究顯示，人們掃描網(wǎng)站，他們不讀他們。”

“flexbox支持IE11。”

“漢堡包的圖標(biāo)是不好的可用性。”

以上所有的報(bào)表（和類(lèi)似的）應(yīng)該來(lái)自。特別是如果你談?wù)摰氖且粋€(gè)有爭(zhēng)議的話題，人們會(huì)討論你。然而，有些語(yǔ)句是意見(jiàn)。如果是這樣的情況（例如第四點(diǎn)以上），那么你應(yīng)該清楚地說(shuō)明，這是你的觀點(diǎn)，并給出理由。

作為一個(gè)例子，這篇文章對(duì)可訪問(wèn)性提到了一些案例研究。注意這些研究并不僅僅是討論，它們是來(lái)源于鏈接。

鏈接到文檔

要鏈接到源點(diǎn)相關(guān)的，如果你正在談?wù)摰奶囟üδ艿囊龑?dǎo)，或蔬菜，或其他工具或框架，你應(yīng)該聯(lián)系的部分在他們的文檔，你需要討論。例如，如果你正在談?wù)摰腂ootstrap的超大屏幕組件，連接到它。

有時(shí)候我覺(jué)得作者害怕鏈接到一個(gè)工具的文檔，因?yàn)樗麄冇X(jué)得他們會(huì)暴露他們的研究的秘密”。也許我錯(cuò)了，但這似乎是這樣的。

鏈接到特定的文檔部分，幫助讀者有一些額外的東西來(lái)尋找應(yīng)該出現(xiàn)的需求。它表明你尊重這個(gè)工具的官方文檔的權(quán)限，并獲得讀者的尊重。

連接到最新版本的規(guī)格

我犯了這個(gè)錯(cuò)誤，我?guī)状巍Ｈ绻阏f(shuō)的是，例如，你可以搜索flexbox，規(guī)格和找到一個(gè)鏈接是這樣的：

http://www.w3.org/tr/2014/wd-css-flexbox-1-20140325/

但這是一個(gè)靜態(tài)版本的規(guī)格，不會(huì)改變。你想要的是對(duì)規(guī)范的當(dāng)前版本的永久鏈接，確保URL看起來(lái)更像這：

http://dev.w3.org/csswg/css-flexbox/

有時(shí)，不幸的是，一個(gè)谷歌搜索會(huì)帶來(lái)一個(gè)“快照”的版本。你可以通過(guò)網(wǎng)址來(lái)告訴你。