Searching txt.sour.is

Twts matching #reading
Sort by: Newest, Oldest, Most Relevant
In-reply-to » This document is the result of a series of discussions between Robert "Uncle Bob" Martin and John Ousterhout, held between September 2024 and February 2025. The text addresses three main topics: method length, comments, and Test Driven Development (TDD). https://github.com/johnousterhout/aposd-vs-clean-code/blob/main/README.md This is something to read and reflect on for days.

@andros@twtxt.andros.dev Just before the pandemic, we watched Uncle Bob videos once a week in the lunch break. While almost all of my old teammates agreed with his views, I partially found them to be very odd and even counterproductive.

I didn’t come across John Ousterhout or any of his work before, at least not deliberately. So, this document is my first contact.

I only finished the chapter on comments and I totally agree with John so far. This document just manifests to me how weird Bob’s view is on certain subjects.

I always disagreed with the concept of a maximum method length. Sure, generally, shorter functions are probably better, but it always depends. And I’ve certainly seen super short methods that just made the code flow even worse to follow. While “one function should only do one thing” is a nice general rule, I’m 100% in team John with the shown examples. There are cases, where this doesn’t help readability at all. Not even close.

To me, a function always has to justify its existence. Either by reusing it at least at another place or by coming up with dedicated tests for it. But if it is just called once and there are no tests, I almost always decide against it. Personally, I don’t mind longer methods. We just recently had a discussion about that and I lost against two other workmates who are more in Uncle Bob’s camp, they refactored one medium sized method into three very short ones. Luckily, we agree on most other topics.

Lol, what!? The shorter the method, the longer the variables inside? I first thought I misread or the writeup mixed it up. I’ll always do it the other way around.

I’ve been also bitten badly by outdated comments in the past, but Bob must have worked on really terrible projects to end up with such an attitude to dislike comments. Oh well. No doubt, I’ve come across by several orders of magnitude more useless comments, in my experience (autogenerated) JavaDocs fall in the category more frequently than not. So, I know that there are different types of comments. A comment doesn’t automatically mean that it is good and justified.

But I also partially agree with Bob and John and think that a good name has a proper chance to save a comment. Though, when in doubt, I go John’s route and use a shorter name with a comment rather than use a kilometer long identifier. Writing good comments typically takes some time, sometimes much longer than writing the code. It regularly takes me several minutes. It’s a hard art.

I perhaps should read up on John’s work. He seems to be more reasonable and likeminded. :-) Let me continue to complete this document.

⤋ Read More

Kubescape becomes a CNCF incubating project
The CNCF Technical Oversight Committee (TOC) has voted to accept Kubescape as a CNCF incubating project.  Kubescape is an open-source Kubernetes security project designed to offer comprehensive security coverage throughout the entire development and deployment lifecycle…. ⌘ Read more

⤋ Read More

Kubestronaut in Orbit: Samah Eddaoudi
Get to know Samah This week’s Kubestronaut in Orbit is Samah Eddaoudi! As a recent graduate in networks and telecommunications, Samah transitioned into the field of DevOps and cloud engineering, building on her strong technical foundation…. ⌘ Read more

⤋ Read More

Amazon Debuts Alexa+ Generative AI
Amazon today announced the launch of Alexa+, a new version of Alexa that includes large language models, agentic capabilities, services, and devices at scale to redefine “the way we interact with digital assistants.”

Image

Alexa+ is smarter, more personalized, and more proactive about making suggestions … ⌘ Read more

⤋ Read More

Donald Trump Has Launched a War Against the Working Class
Michael Arria,  Staff Writer  -  truthout

_Stephan: As Trump’s fascist oligarch coup moves into its second month I confess I am surprised that Trump voters don’t yet seem to fully realize how severely Trump is going to damage the quality of their personal life, and the lives of their family. I keep seeing interviews with Trump voters, particularly White men, who just don’t seem capable of comprehending what is … ⌘ Read more

⤋ Read More

Trump allies circulate mass deportation plan calling for ‘processing camps’ and a private citizen ‘army’
Dasha Burns and Myah Ward,  Staff Writer  -  Politico

_Stephan: This is straight out of Hitler’s takeover of Germany’s democracy, an evil scheme cooked up by fascist Erik Prince and his cohort of fascist military contractors. I hope you realize that under Trump we are less than two months into the Trump coup at best a pse … ⌘ Read more

⤋ Read More

Trump approval rating holds steady at 44%, Reuters/Ipsos poll finds
,    -  Reuters/IPSO

_Stephan: Trump voters seem psychologically unable to reconsider their adoration and loyalty to criminal Trump, even as he announces scheme after scheme to destroy the quality of their lives. I did not understand how it was possible for Hitler to destroy democracy and impose authoritarian control over Germany in 1933, but watching the docile Republican sheep continue to … ⌘ Read more

⤋ Read More

Trump’s funding freeze is wreaking havoc on climate science
Zoya Teirstein,  Staff Writer  -  Grist

_Stephan: This is what really holds long-term consequences for not only Americans but global humanity. Criminal Trump’s, Musk led, defunding of climate science research. Without this research, we will neither understand nor be prepared for what I believe will be a civilization-altering crisis within 15 years. It will largely be based on what climate change, as a resul … ⌘ Read more

⤋ Read More

I read a lot about Clean Code, SOLID, TDD, DDD… now I’m discovering «A Philosophy of Software Design»… but nobody talks about the importance of the project architecture. Do we depend on the framework to do the work for us?
You know I’m a big fan of Clean Architecture, but I feel alone when I share my thoughts on social media or at work.
You have to think outside the framework.

⤋ Read More

Ten Disturbing Stories About the Dark Side of Mindfulness
In this frenzied day and age, more and more of us are turning to mindfulness to lower our stress and center ourselves. Based on Buddhist meditation, mindfulness spans a range of techniques that ask people to be more aware of their thoughts and feelings. The benefits of mindfulness are well documented. But while some gurus […]

The post [Ten Disturbing Stories About the Dark Side of Mindfulness](https://listverse.com/2 … ⌘ Read more

⤋ Read More

Cette diversité artificielle n’est pas arrivée par hasard
L’actualité nous rappelle, parfois cruellement, que la diversité de nos sociétés ne signifie pas systématiquement « enrichissement » comme tentent de nous le faire croire un nombre chaque jour plus minoritaire de politiciens. Alors oui, certes et comme l’a récemment montré une enquête relayée par Le Point, cette diversité permet de fournir les bataillons de pédaleurs qui […] ⌘ Read more

⤋ Read More

10 Incredibly Dangerous Jobs That No Longer Exist
The dangerous jobs of the past often feel like works of fiction. Improved technology, better regulations, and widespread information have removed many of the greatest dangers from the average profession. Once upon a time, though, people would regularly risk dying just to make a living. And while some of those dangerous jobs were awful necessities […]

The post [10 Incredibly Dangerous Jobs That No Longer Exist](https://listverse.com/ … ⌘ Read more

⤋ Read More

Haasoscope Pro Open Source USB Oscilloscope with 2 GHz Bandwidth and 3.2 GS/s Sampling
Crowd Supply recently launched Haasoscope Pro, an upgraded version of the original open-source USB oscilloscope introduced in 2018. It features a 2 GHz bandwidth, 12-bit resolution, and a 3.2 GS/s sampling rate, providing an open-hardware solution for high-speed signal analysis. According to the product page, oscilloscopes with bandwidths above 1 GHz are typically designe … ⌘ Read more

⤋ Read More

ameriDroid Opens Preorders for VPN Server with WireGuard and DietPi
The VPN Server by ameriDroid is a pre-configured device for secure remote access to home and small office networks. Built on the ODROID-C4, it runs a lightweight Linux-based system with WireGuard for encrypted VPN connections and minimal setup. The device is based on the ODROID-C4, a single-board computer released in early 2020 by Hardkernel, featuring […] ⌘ Read more

⤋ Read More

MCP 實戰:使用 Go 快速構建 MCP Server
MCP 簡介MCP 協議(Model Context Protocol,模型上下文協議)是由 Anthropic 於 2024 年 11 月底推出的一種開放標準,旨在統一大型語言模型(LLM)與外部數據源和工具之間的通信。官方地址 https://modelcontextprotocol.io 架構如下 MCP 協議的架構包含多個關鍵組件:Host(宿主程序)、MCP Client(M ⌘ Read more

⤋ Read More

Go 1-24 新特性:標準庫 os-Root 解析
背景 ——–Go 1.24 已進 release,其版本說明 [1] 中包含了多項新特性。本文將重點解析新增的標準庫 os.Root 功能,它能有效防禦目錄遍歷漏洞(Directory Traversal Vulnerabilities)。目錄遍歷漏洞是典型的安全問題,攻擊者通過提供相對路徑(如 ../../../etc/passwd)誘導程序訪問非授權文件。近期真實案例 CVE- ⌘ Read more

⤋ Read More

DietPi Late February 2025 Update (Version 9.11)
The late February update of DietPi v9.11 introduces support for Pi-hole v6 while improving system stability, first-boot automation, and network reliability during initial setup, along with resolving kernel selection issues on Raspberry Pi.       DietPi: DietPi is a lightweight, optimized Linux-based operating system designed for single-board computers and embedded systems. It provides an […] ⌘ Read more

⤋ Read More

Quick macOS Tip: Create and Use Text Clippings for Productivity
In macOS, a Text Clipping is a selection of text that you’ve dragged from an application to another location on your Mac, where it becomes a unique kind of standalone file.

The relatively little-known feature has been around since at least Mac OS 9, and it offers a convenient way to save out pieces of text from pretty much anywhere for later use in another app or document.

![](https://images.macrumors.com/article-new/2025/02 … ⌘ Read more

⤋ Read More

How to Share an AirTag with Someone Else
Sharing an AirTag with someone makes it super easy for multiple people to track a single item through the Find My app and network. For example, maybe you want track some baggage as it is traveling around the country or world and share that AirTag equipped luggage with a friend or colleague, or maybe you … Read MoreRead more

⤋ Read More

Boog900, hinto-janai, vtnerd CCS proposals ready for funding
Three CCS proposals have been moved to the funding stage and are now looking for community support:

  • Boog900’s !544 1: full time work on Cuprate (3 months) + January 2
  • hinto-janai’s !543 3: full-time work (3 months) 4
  • vtnerd’s !553 5: full-time 2025 q1/q2 6

To support the above proposals you can donate to the XMR addresses listed on the _Funding Requi … ⌘ Read more

⤋ Read More

Monero Research Lab meeting scheduled for 5 March 2025 1700 UTC
The next Monero Research Lab1 meeting is scheduled to take place on Wednesday, March 5th 2025 at 17:00 UTC on IRC-Libera/Matrix2 in the #monero-research-lab channels.

Agenda overview (unconfirmed)
  • Updates
  • Prize contest to optimize some FCMP cryptography code3
  • Release of OSPEAD HackerOne and CCS milestone submissions4
  • Research on subnet deduplication for peer selection to reduce spy node ris … ⌘ Read more

⤋ Read More

spirobel submits CCS proposal to develop Monero Payment Links, Browser Wallet, multisig companion app
spirobel1 has submitted a CCS proposal2 to finish developing the Monero Browser Wallet3, create a self-hostable Stripe Payment Links 4 alternative5 and a multisig companion app, in an effort to make XMR web shopping more convenient and secure:

Currently Monero shoppers have to copy and paste addresses from the t … ⌘ Read more

⤋ Read More

Announcing the Kubernetes “Shift Down” Security Paper
The CNCF Kubernetes Policy Working group (WG) has just released the Shift Down Security paper to help educate the community about how organizations can leverage cloud native security best practices to address key business risks and… ⌘ Read more

⤋ Read More

So I contact the Miramar Police West District Station just now to seek help in finding out if a business called Claro Enterprise Solutions locat …
So I contact the Miramar Police West District Station just now to seek help in finding out if a business called Claro Enterprise Solutions located at 3350 SW 148th Ave #400, Miramar, FL 33027, Estados Unidos with phone number +19545177301 actually exists, is legit and to validate the phone number.

Why? Because someone or something from this ASN (netwo … ⌘ Read more

⤋ Read More

U.S. opposes Ukraine territorial integrity in UN vote
Gregory Walton/ Amélie Bottollier-Depois ,  Staff Writers  -  Agence France-Presses (France) | Raw Story

_Stephan: The Trump coup has now defined itself in a way that has stunned not just me but all the democracies of the world. The United States has aligned itself with dictator-ruled Russia rather than a Russia-invaded democracy, Ukraine. I don’t believe any geopolitically sophisticated American would have believed t … ⌘ Read more

⤋ Read More

Neo-Nazi group plots rebuild as Trump’s FBI chief takes helm, audio reveals
Ben Makuch,  Reporter  -  The Guardian (U.K.)

Stephan: Every day now In media, particularly media based in non-U.S. democracies, I see increasing references noting the correlation between the Trump coup and the rise of Hitler’s Nazisism. Very scary.

Image

_Members of the Base at … ⌘ Read more

⤋ Read More

The Housing Loophole That Lets Wealthy Investors Raise Rents on Poor Tenants
Jesse Coburn,  Staff Writer  -  ProPublica

_Stephan: An SR reader, who describes herself as a “retired teacher” wrote to tell me she was just notified her rent in an apartment building that was sold by its owner to an investment group will be going up 25%, and she is not sure she can afford it. That prompted me to do some research to see what is going on with rents for ren … ⌘ Read more

⤋ Read More

Trump Backs House GOP Bill Slashing $1 Trillion From Medicaid and Food Stamps
Chris Walker ,  Staff Writer  -  truthout

_Stephan: I was just told today by the office of one of my physicians that telemedicine, doing a video meeting with a physician, will no longer be covered by Medicare. That, for me, is a big deal. I live on an island and going to a medical appointment on the mainland when all that is involved is a conversation, is an all-day opera … ⌘ Read more

⤋ Read More

Testing the World’s Thinnest Foldable Smartphone
Chinese smartphone maker Oppo recently came out with the Find N5, which is a super thin and lightweight foldable smartphone. It’s thinner and lighter than Samsung’s foldable devices, and Apple’s non-foldable ones.

_Subscribe to the MacRumors YouTube channel for more videos._

The Find N5 has a 6.62-inch display when closed, and an 8.12-inch display when open, so when unfolded, it’s just a bit smalle … ⌘ Read more

⤋ Read More

Go 項目目錄結構指南
擁有一個井然有序的目錄結構非常重要,原因有幾個:層次分離:它將項目的不同部分——如業務邏輯、數據訪問和 API 處理——放在各自的文件夾中。這樣,開發人員可以專注於特定領域,而不會感到不知所措或困惑。 更好的組織: 通過整齊地整理你的代碼及其依賴項,較大的項目變得更容易導航。你總是知道在哪裏找到你需要的東西! 可重用性: 一個良好的結構讓你可以創建可以在項目不同部分使用的組件或包,從而 ⌘ Read more

⤋ Read More

golang 每日一庫 samber-lo
samber/lo 是一個非常流行的 Go 語言庫,它提供了一些常用的函數式編程風格的工具函數,使得 Go 代碼更加簡潔、優雅。該庫的設計理念是減少代碼冗餘,簡化開發過程,尤其是在處理常見的數據結構和算法時。lo 這個庫的名字來源於 “Lazily Optimized” 的縮寫,但它本身並不涉及延遲計算或優化策略。它的目標是提供一系列常見操作的簡便方法,尤其是集合類型(如切片、映射、通道等)的操作 ⌘ Read more

⤋ Read More

10 Creative Technologies Taking on Climate Change
As climate change intensifies, the need for innovative solutions has never been more urgent. Scientists, entrepreneurs, and communities around the world are creating new technologies and implementing unique strategies to combat environmental issues from all angles. While some well-known initiatives like solar power and electric cars are common in the fight against climate change, many […]

The post [10 Creative Technologies Taking on … ⌘ Read more

⤋ Read More

10 Classic American Songs That Started in Minstrelsy
In the early 1800s, Americans used to enjoy minstrel shows. Essentially, watching white men dance and sing their hearts out—while wearing blackface and mocking African Americans. This practice continued into the 19th century, even being seen in Hollywood films and on TV. Minstrel shows have been called the first truly American form of theater. While […]

The post [10 Classic American Songs That Started in Minstrelsy](https://li … ⌘ Read more

⤋ Read More

Go 語言之在 Gin 框架中使用 Zap 實現高效日誌管理
在現代 Web 開發中,日誌管理是確保應用程序性能、穩定性和可維護性的關鍵因素之一。Gin 作爲輕量級的 Go Web 框架,自帶了簡單的日誌功能。然而,對於追求高性能和靈活性的開發者來說,Zap 日誌庫是一個理想的選擇。本文將深入探討如何在 Gin 框架中集成 Zap 日誌庫,實現高效、分級和結構化的日誌記錄。本文介紹瞭如何在 Go 的 Gin 框架中使用 Zap 日誌庫替換默認日誌功能,提供更 ⌘ Read more

⤋ Read More

golang 每日一庫之 pressly-goose
pressly/goose 是一個用於 Go 語言的數據庫遷移工具。它提供了一種簡單且高效的方式來管理數據庫 schema 的版本控制,適用於數據庫結構變更的管理和遷移。goose 的設計目標是讓數據庫遷移更加簡便、安全,並且在多環境下可以輕鬆應用。數據庫遷移通常用於在應用程序中管理數據模式的變化(例如添加表、修改列、刪除索引等),尤其在團隊協作開發、生產環境發佈等情境下,遷移工具幫助開發者和運維 ⌘ Read more

⤋ Read More

golang 每日一庫之 iancoleman-orderedmap
github.com/iancoleman/orderedmap 是一個 Go 語言庫,提供了一個有序字典(OrderedMap)實現,區別於 Go 語言內建的 map 類型,內建的 map 是無序的。該庫的 OrderedMap 能夠保持元素的插入順序,因此適用於需要按插入順序遍歷元素的場景。主要特點:有序性:OrderedMap  保證元素的插入順序,和內建的 map 類型不同, ⌘ Read more

⤋ Read More

Go 編程實踐 - Go Context
1、context 包的引入context 包是在 Go 1.7 引入的,它爲在多個 goroutine 之間傳遞請求範圍的上下文信息和控制 goroutine 的生命週期提供了一種標準的方式。2、context 包的主要作用傳遞上下文信息:context 可用於在 goroutine 之間傳遞請求範圍的數據,如請求的認證信息、請求的截止時間、請求的 ID 等。這些信息在 goroutine 之間 ⌘ Read more

⤋ Read More

golang 每日一庫之 swaggo
Go Swagger(Swaggo)是一個用於 Go 語言的開源工具集,它幫助開發者自動生成 API 文檔。它利用 Go 的註釋和結構體信息,通過解析代碼,生成符合 OpenAPI 規範的文檔。OpenAPI(也稱爲 Swagger)是一個廣泛使用的 API 規範,它使得 API 文檔更加標準化、易於理解和交互。Swaggo 主要的功能包括:1. 自動生成 OpenAPI 文檔Swaggo 通過解 ⌘ Read more

⤋ Read More

Go 事件驅動架構:從原理到實戰,徹底掌握高併發編程
在 Go 語言的世界裏,如何優雅地處理海量併發請求?事件驅動架構(Event-Driven Architecture, EDA)或許是你需要的答案。 🔥 爲什麼你需要關注事件驅動架構? ———————-在傳統的同步編程模式下,我們通常採用阻塞調用的方式來處理請求。然而,在高併發、高吞吐的場景下,這種方式可能帶來以下問題:線程資源浪費:大量 Goroutine 在 I ⌘ Read more

⤋ Read More

Apple and Indonesia Reach Deal to End iPhone 16 Ban
Apple and Indonesia have agreed on terms to lift the country’s five-month ban on iPhone 16 sales, according to people familiar with the matter who spoke to Bloomberg. The deal concludes a battle that began in October, when Indonesia refused to issue permits for Apple’s flagship iPhone lineup over Apple’s failure to comply … ⌘ Read more

⤋ Read More

Cuprate Meeting scheduled for 4 March 2025 1800 UTC
The next Cuprate Meeting is scheduled1 to take place on Tuesday, March 4 2025 at 18:00 UTC on IRC-Libera/Matrix2 in the #cuprate channels.

Cuprate is an effort to create an alternative Monero node implementation.

Agenda overview
Greetings
Updates: What is everyone working on?
Project: What is next for Cuprate?
Any other business

The meeting’s moderator should be Boog9003. Consult the Cuprate code repositor … ⌘ Read more

⤋ Read More