mastodon.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
The original server operated by the Mastodon gGmbH non-profit

Administered by:

Server stats:

338K
active users

#文檔

0 posts0 participants0 posts today

On Long Term Software Development - Bert Hubert's writings

Link
📌 Summary: 最近,荷蘭選舉委員會邀請我就他們的開源Abacusvote計算軟體發表演講。這次討論集中於長期軟體開發的挑戰與實踐,包括管理依賴、測試、簡化代碼及文檔的重要性。依賴性管理被認為關鍵,因為依賴可能隨時間變化,影響系統的穩定性與安全性。同時,儘早重構和減少不必要的代碼也能避免複雜性升高。演講還強調持續的測試與良好的文檔對於軟體可維護性的重要性,並呼籲保持團隊穩定性和考慮開源策略來提高代碼質量。

🎯 Key Points:
- 依賴性管理: 減少依賴數量,審查其安全性及持續維護的可能性。
- 測試: 大量測試可以提供及時反饋並幫助在重構時檢查系統功能。
- 簡化代碼: 保持代碼簡單,必要時再增加複雜性,以防未來的維護困難。
- 文檔: 詳細記錄系統設計哲學及代碼說明,特別是代碼改進的原因。
- 團隊穩定性: 優先維持團隊成員的長期僱用,避免依賴外包團隊。

🔖 Keywords: #依賴性管理 #測試 #簡化代碼 #文檔 #團隊穩定性
Bert Hubert's writings · On Long Term Software Development - Bert Hubert's writings
More from bert hubert 🇺🇦🇪🇺🇺🇦

🌗 設計師文檔無障礙性和使用者互動指南
➤ 設計師如何在文檔中記錄無障礙性和使用者互動需求
stephaniewalter.design/blog/a-
本文探討了無障礙性在設計項目中的重要性,並介紹了設計師如何在文檔中記錄不同方面的無障礙性和使用者互動需求,以便從一開始就構建更好、更具包容性的產品。
+ 這篇文章清楚地解釋了為什麼無障礙性文檔對於設計項目的重要性,對設計師來說非常有用。
+ 這篇文章提供了實用且易於理解的建議,對於想要更深入瞭解無障礙性設計的人來說會很有幫助。

Stéphanie Walter - Senior UX Designer, Mobile Expert, Conference Speaker, Blog writer and Teacher. · A Designer’s Guide to Documenting Accessibility & User Interactions by Stéphanie WalterWhy, what and how designers should document accessibility requirements and user interactions to make product better and more inclusive

🌖 Livebook是文檔的祕密武器 · The Fly Blog
➤ Livebook的功能和應用
fly.io/blog/livebook-for-app-d
Livebook是一個強大的文檔工具,可以幫助開發人員理解和學習代碼,並提供互動探索和展示應用程序邏輯的功能。它可以用於機器學習領域,也可以在常規的Phoenix Web項目中使用。Livebook具有代碼完成、代碼執行、Markdown文本解釋等重要功能,並且可以將筆記本文件保存為純文本文件,方便版本控制。它可以幫助團隊更好地理解和記錄應用程序的核心代碼,並提供互動的學習體驗。
+ 這個工具聽起來很有用,我想試試看在我的項目中使用Livebook。
+ Livebook的互動學習功能對於新開發人員來說非常有價值,可以幫助他們更快地理解和熟悉代碼。

FlyLivebook is a secret weapon for documentationDocumentation and guides from the team at Fly.io.

🌖 Discord不是文檔 - Terence Eden的博客
➤ Discord不是文檔的替代品
shkspr.mobi/blog/2023/07/disco
Discord是一個即時通訊工具,但不適合作為文檔的替代品。作者對Watchy開發平臺的文檔不滿,因為它們只提供了一個基本指南,其他問題需要在Discord上提問。作者認為這樣做很糟糕,因為在Discord上找到相關信息很困難,而且新手問問題時還會遭到冷嘲熱諷。作者認為至少應該將常見問題整理到一個地方,而不是隻依賴即時通訊工具。
+ 這篇文章提醒我們,即時通訊工具不能取代完整的文檔。

Terence Eden’s Blog · Discord is not Documentation
More from Terence Eden

🌘 Linode的文件作為代碼
➤ 文件作為代碼的方法在Linode的應用
linode.com/blog/linode/docs-as
這篇文章介紹了Linode的技術寫作團隊如何採用文件作為代碼的方法來編寫和維護文檔。這種方法使用相同的工具來編寫文檔和編寫軟件,並且帶來了許多好處,包括更好的協作,更好的理解和更快的編譯速度。
+ 這種方法聽起來很有趣,我也想試試看。
+ 使用文件作為代碼的方法確實可以提高效率和協作。

AkamaiDocs as Code at LinodeDocs as code is a methodology where the tools you use for writing documentation are the same as the tools used for writing software.

🌗 改革自由軟件的信息
➤ 介紹writefreesoftware.org網站,解決自由軟件基金會網站不易理解和不易訪問的問題
drewdevault.com/2023/06/19/Ref
本文介紹了一個名為writefreesoftware.org的網站,它是一個全面介紹自由軟件哲學和實現的資源,旨在解決自由軟件基金會網站不易理解和不易訪問的問題。該網站是自由軟件,並提供源代碼。作者呼籲更多人參與其中,以推動自由軟件運動的發展。
+ 這是一個很好的資源,對於想要了解自由軟件哲學和實現的人來說非常有用。
+ 自由軟件運動需要更多這樣的資源,讓更多人參與其中,推動自由軟件的發展。

drewdevault.comReforming the free software message

🌘 Robert Haas:PostgreSQL文檔和社區限制
➤ PostgreSQL文檔的優點和缺點
rhaas.blogspot.com/2023/06/the
PostgreSQL文檔的優點是非常精確,但缺點是缺乏整體性。文檔更新通常由最熟悉代碼更改的開發人員進行。因此,如果對文檔進行更改對代碼沒有幫助,則不太可能進行更改。由於開發人員的時間主要用於編寫代碼,因此更新文檔變成了一項必須完成的任務,以便提交代碼,然後進入下一個項目並編寫更多代碼。因此,文檔的整體結構可能不是最佳的。即使有人嘗試進行更改,這些更改通常也會遇到困難。因此,文檔的整體結構可能不是最佳的。
+ 這篇文章很好地解釋了PostgreSQL文檔的優點和缺點。它讓我更好地了解了PostgreSQL社區的運作方式。
+ 這篇文章非常有用,因為它提供了關於PostgreSQL文檔的深入洞察。我希望PostgreSQL社區能夠解決這些問題,以便更好地支持用戶。

rhaas.blogspot.comThe PostgreSQL Documentation and the Limitations of CommunityIn my opinion, the PostgreSQL documentation is simultaneously excellent and fairly poor, and both its excellence and its shortcomings are di...

🌗 Vrite - 技術內容的無頭 CMS
➤ 開源的無頭內容管理系統,適用於編程博客、文檔等技術內容。
vrite.io/
Vrite 是一個開源的無頭內容管理系統,適用於編程博客、文檔等技術內容。它提供了一個全方位的技術內容工具包,從編寫到發布,讓您輕鬆創建美麗的內容。它還提供了強大的 API、多種集成和多功能的內容格式,讓您只需拖放即可發布內容。
+ 這是一個非常好的 CMS,它提供了很多有用的功能,讓我們輕鬆創建和管理技術內容。
+ Vrite 的 API 和集成非常強大,讓我們可以輕鬆地將內容發布到不同的平台上。

vrite.ioVrite - developer content platformOpen-Source, collaborative developer content platform for documentation, technical blogs, and more.