正如您可能已經知道，自2014一月以來我一直致力于為SitePoint作為他們的一個責任編輯，主要是編輯HTML，CSS，和非內容。我也幫著移動內容，javascript，一些通用的網站的東西（Git的文章，構建工具，和其他通用的內容），我寫的主要通訊SitePoint的每星期。

我愛我的工作在SitePoint的這是我曾經最好的工作了。只要SitePoint仍然希望我為他們工作，我希望我能繼續幫助他們把內容更好的前端開發人員。

自從我開始編輯工作以來，我已經拒絕或發送一些編輯文章了。許多人拒絕遭受同樣的問題。所以對于這篇文章，我把我的想法放在我認為對一個好的網頁開發文章或教程。

一些開場白

在進入這之前，讓我們從中得到一些東西：

不是每個人都會同意我的觀點。

我不寫這篇文章，因為我覺得我比別人好。我們都有自己的優勢。我不完美。我可以說出100個比我好的開發者/作家。

許多在這個崗位的項目是從一個文件我已經有一段時間了，我已經通過了編譯，對作家SitePoint，幫助他們提高。

這些技巧中的許多適用于任何類型的寫作，不僅是技術或發展。

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

有了，有點拖了出來（更晚了?。?，讓我們到主要觀點。

添加支持語句的鏈接

文章幾乎總是有參考鏈接。如果你寫的是前端技術，你的內容應該慷慨地連接到類似的東西：

W3C規范

MDN的參考

權威文章受到尊敬的社會成員

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

如果你對一個特定的工具或技術（如特定的jQuery插件或CSS預處理器），你的第一段應該鏈接到首頁，技術。如果你是在談論一個新的工具或技術或者一個不是眾所周知的。在某些情況下，如果工具是常見的上下文（如在博客上關于SASS Sass），那么你可能是罰款不包括一個鏈接到SASS的主頁。

你還應該包括鏈接，以支持某些類型的報表。例如：

“谷歌認為搜索引擎優化排名的頁面速度。”

“研究顯示，人們掃描網站，他們不讀他們?！?/span>

“flexbox支持IE11?！?/span>

“漢堡包的圖標是不好的可用性?！?/span>

以上所有的報表（和類似的）應該來自。特別是如果你談論的是一個有爭議的話題，人們會討論你。然而，有些語句是意見。如果是這樣的情況（例如第四點以上），那么你應該清楚地說明，這是你的觀點，并給出理由。

作為一個例子，這篇文章對可訪問性提到了一些案例研究。注意這些研究并不僅僅是討論，它們是來源于鏈接。

鏈接到文檔

要鏈接到源點相關的，如果你正在談論的特定功能的引導，或蔬菜，或其他工具或框架，你應該聯系的部分在他們的文檔，你需要討論。例如，如果你正在談論的Bootstrap的超大屏幕組件，連接到它。

有時候我覺得作者害怕鏈接到一個工具的文檔，因為他們覺得他們會暴露他們的研究的秘密”。也許我錯了，但這似乎是這樣的。

鏈接到特定的文檔部分，幫助讀者有一些額外的東西來尋找應該出現的需求。它表明你尊重這個工具的官方文檔的權限，并獲得讀者的尊重。

連接到最新版本的規格

我犯了這個錯誤，我幾次。如果你說的是，例如，你可以搜索flexbox，規格和找到一個鏈接是這樣的：

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

但這是一個靜態版本的規格，不會改變。你想要的是對規范的當前版本的永久鏈接，確保URL看起來更像這：

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

有時，不幸的是，一個谷歌搜索會帶來一個“快照”的版本。你可以通過網址來告訴你。