文章

學習如何為練習撰寫文章


每個練習都可以有相關的文章,用來探討該練習中某個有趣的面向。

主題

文章可以探討的主題包括:

  • 比較不同做法的效能
  • 只要是你想得到的有趣主題都行喔!

一般考量

  • 如果你的文章是根據自己寫的某些程式碼,可以考慮把那些程式碼一併提交(放在文章目錄裡)
    • 例如一篇談效能的文章,就為它寫了效能測試程式碼

該為哪些練習撰寫文章?

任何練習都行,只要其中有值得探索的有趣內容。

檔案

每篇文章都必須新增以下兩個檔案:

  • .articles/<article-slug>/content.md:文章的說明(參見文件)
  • .articles/<article-slug>/snippet.md:展示該文章的片段(參見文件)

接著你需要新增或更新:

  • .articles/config.json:文章的中繼資料(參見文件)