外媒速遞:API說明文檔相關最佳實踐綜述
原創(chuàng)【51CTO.com原創(chuàng)稿件】外媒速遞是核子可樂精選的近日國外媒體的精彩文章推薦,希望大家喜歡!
本期給大家推薦的是API說明文檔相關***實踐綜述、十二項基本要素助你走向云成功、六項提示幫你利用技術轉型實現DevSecOps和十款免費插件助你在WordPress中實現各類動畫效果等。
一、API說明文檔相關***實踐綜述
原文標題:Best Practices in API Documentation
API的實際效果在很大程度上取決于其文檔質量。如果人們不知道該如何使用,那么,再出色的API也將毫無用武之處。這也引出了今天的討論議題——我們該如何編寫出理想的API說明文檔?與技術領域的其它任務一樣,文檔編寫同樣應當遵循以下幾項***實踐。
1. 明確API說明文檔的具體受眾
2. 驗證機制
3. 錯誤消息
4. 資源
5. 使用方式
6. 變更日志
7. 避免大量使用術語
8. 處理請求與響應
9. 將更多資源引入您的說明文檔
10. 提供上手指南
11. SDK與庫
12. 交互式控制臺
13. 良好的API說明文檔需要投入時間與精力方可建立,但確實物有所值
二、十二項基本要素助你走向云成功
原文標題:12 Factors to Cloud Success
作為一位開發(fā)者,大家是否希望你的應用程序能夠配合各項***實踐在云環(huán)境中取得理想運行效果?如果答案是肯定的,那么請關注“十二因素應用”這一概念。這是一種專門用于構建軟件即服務的方法。在今天的文章中,我們將共同了解這“十二因素”,并探討它如何提升我們的云應用運行表現。
1. 代碼庫
2.依賴關系
3. 配置
4. 后端服務
5. 構建、發(fā)布與運行
6. 流程
7. 移植綁定
8. 并發(fā)性
9. 可處置性
10. 開發(fā)/生產部分
11. 日志
12. 管理員流程
三、六項提示幫你利用技術轉型實現DevSecOps
原文標題:6 Tips for Transforming Technology to Achieve DevSecOps
DevSecOps的核心目標在于為快速與安全軟件開發(fā)建立起一道對接橋梁。作為DevSecOps的基礎,我們應當將DevOps與AppSec加以結合,并高度關注如何利用質量與流程機制支持持續(xù)改進與快速學習。然而,如果缺少必要的技術方案,那么,DevSecOps同樣無從談起。下面,我們將了解六項能夠幫助大家實現相關技術轉型的重要提示。
1. 安全自動化
2. 盡早檢測安全漏洞
3. 對Build進行拆分
4. 關注高誤報率問題
5. 使用綜合分析機制
6. 強調編排的重要作用
四、十款免費插件助你在WordPress中實現各類動畫效果
原文標題:10 Free Plugins for Animation Effects in WordPress
時至今日,動畫效果已經成為各類WordPress網站實現個性化表達的重要途徑。另外,動畫效果也能夠幫助大家成功將受眾的注意力引導至關鍵性內容身上,從而強化用戶體驗。在今天的文章中,我們將共同了解十款可用于實現多種動畫效果的免費插件。
1. SVG Logo
2. Animate It
3. Page Loading Effects
4. Page Animations and Trasitions
5. WP Progress Bar
6. CSS3 Transitions
7. CSS3 Rotating Words
8. Easy Textillate
9. Page Scroll to ID
10. Ultimate Hover Effects
【51CTO原創(chuàng)稿件,合作站點轉載請注明原文作者和出處為51CTO.com】