paint-brush
Proglogging: Bộ công cụ thám tử của nhà phát triểntừ tác giả@offcode
406 lượt đọc
406 lượt đọc

Proglogging: Bộ công cụ thám tử của nhà phát triển

từ tác giả Adam Schmideg10m2023/10/09
Read on Terminal Reader

dài quá đọc không nổi

Đối với Marco, một nhà phát triển phần mềm có trụ sở tại San Francisco, buổi sáng thường bắt đầu bằng một tách cà phê nóng hổi và lướt qua những tin tức văn học và công nghệ mới nhất.
featured image - Proglogging: Bộ công cụ thám tử của nhà phát triển
Adam Schmideg HackerNoon profile picture
0-item
1-item

Bản thảo bị thất lạc của Sherlock Holmes


Trong một khám phá đáng kinh ngạc đã gây chấn động khắp thế giới văn học, một bản thảo chưa từng được biết đến của câu chuyện Sherlock Holmes đã được khai quật. Ẩn mình trong căn gác mái bụi bặm của một ngôi nhà thời Victoria ở quận Bloomsbury lịch sử của London, bản thảo không chỉ cung cấp một câu chuyện chưa được kể về vị thám tử nổi tiếng nhất thế giới mà còn tiết lộ một công cụ phương pháp được sử dụng để giải quyết vụ án - một cách tiếp cận có cấu trúc mà Tiến sĩ John C. John Watson gọi là “Chỉ mục điều tra”.

sự khám phá

Bản thảo được đưa ra ánh sáng trong một cuộc mua bán bất động sản thông thường. Người họ hàng cuối cùng còn sống của chủ sở hữu ban đầu của ngôi nhà, anh họ xa của Ngài Arthur Conan Doyle, không hề biết gì về kho báu được giấu trong một chiếc hòm hấp cách đây hàng thế kỷ. Chỉ khi một người định giá, chuyên về sách cổ, tình cờ nhìn thấy một chồng giấy ố vàng được buộc gọn gàng bằng dây thừng thì người ta mới hiểu được ý nghĩa to lớn của phát hiện này.

Chỉ số điều tra

Điều khiến bản thảo này khác biệt với những câu chuyện khác của Holmes là tài liệu tỉ mỉ của Tiến sĩ Watson về quá trình điều tra của họ bằng phương pháp mà ông gọi là “Chỉ mục điều tra”. Có vẻ như Watson đã sử dụng hình thức ghi nhật ký có cấu trúc này để lập danh mục các quan sát, câu hỏi và suy luận một cách có tổ chức. Mục lục không chỉ là một công cụ kể chuyện mà còn là một phần không thể thiếu của câu chuyện, hướng dẫn Holmes và Watson vượt qua mê cung của những manh mối phức tạp và những lời chỉ trích đỏ.


“Chỉ mục truy vấn” được trình bày hết sức chú ý đến từng chi tiết, sử dụng các động từ cụ thể để bắt đầu mỗi mục, đóng vai trò vừa là điểm hành động vừa là phản ánh. Các ghi chú của Watson trong bản thảo gợi ý rằng ông xem “Chỉ mục điều tra” như một công cụ phổ quát, có thể thích ứng với nhiều hình thức điều tra khác nhau, không chỉ giới hạn trong công việc thám tử.

Ý nghĩa

Các học giả cũng như người hâm mộ đều bị hấp dẫn bởi khía cạnh mới này của kinh điển Holmesian. Tiến sĩ Eleanor Hughes, một chuyên gia văn học nổi tiếng thời Victoria, nhận xét: “Chỉ số Điều tra bổ sung thêm một lớp hoàn toàn mới cho động lực Holmes-Watson. Nó không chỉ là một phương pháp giải quyết vụ án; đó là cánh cửa dẫn vào những bộ óc kỷ luật đã khiến họ trở thành bộ đôi thám tử xuất sắc.”


Ngoài việc khơi dậy mối quan tâm học thuật mới, “Chỉ số điều tra” còn thu hút sự chú ý của các chuyên gia trong nhiều lĩnh vực khác nhau, từ báo chí điều tra đến phát triển phần mềm, như một phương pháp vượt thời gian để giải quyết vấn đề có cấu trúc.

Cái gì tiếp theo?

Khi những nỗ lực đang được tiến hành để xác thực bản thảo và nếu được xác nhận là xác thực thì sẽ xuất bản nó cho cả thế giới xem, có một điều chắc chắn: “Danh mục điều tra” hứa hẹn sẽ là chủ đề thảo luận và điều chỉnh trong nhiều năm tới. Thứ từng là công cụ thời Victoria để giải quyết những bí ẩn khó hiểu nhất của London có thể sớm trở thành trung tâm của các cuộc đối thoại thế kỷ 21 về tư duy phân tích và tính nghiêm ngặt về phương pháp luận.


Quả thực, việc phát hiện ra bản thảo Sherlock Holmes bị thất lạc này và “Danh mục điều tra” của nó không chỉ làm phong phú thêm hiểu biết của chúng ta về lịch sử văn học mà còn cung cấp một công cụ điều tra vượt thời gian, một lần nữa chứng minh rằng một số phương pháp, như thám tử huyền thoại, là bất tử.


Khi các học giả và những người đam mê văn học háo hức chờ đợi việc xuất bản bản thảo Sherlock Holmes mới được phát hiện, chúng ta được cấp một cái nhìn độc quyền về câu chuyện. Một câu chuyện giàu tính hồi hộp và thách thức cân não, nó nêu bật một phương pháp điều tra có cấu trúc được Tiến sĩ John Watson gọi là “Chỉ số điều tra”. Cách tiếp cận sáng tạo nhằm làm sáng tỏ những bí ẩn này mang đến cái nhìn hấp dẫn về những bộ óc kỷ luật đằng sau bộ đôi thám tử nổi tiếng nhất London. Không dài dòng nữa, chúng tôi xin giới thiệu với bạn một đoạn trích từ câu chuyện thất lạc hấp dẫn này của Sherlock Holmes và vai trò của “Chỉ số điều tra” trong việc giải quyết một trong những vụ án khó hiểu nhất ở London thời Victoria.

Trường hợp của chỉ số điều tra

Những con đường đầy sương mù của London tấp nập xe ngựa và người đi bộ, mỗi người lại đi về trong ngày của mình, mỗi người đều có một câu chuyện để kể. Tuy nhiên, đối với Tiến sĩ John Watson, ngày hôm đó bắt đầu bằng lời giới thiệu đặc biệt về thứ gọi là “Danh mục điều tra” của một người bạn cũ trong chiến tranh. “Đó là một cách để giải quyết sự hỗn loạn, John,” bạn anh nói và đưa cho anh một cuốn nhật ký. Watson, luôn mong muốn tìm ra những cách tốt hơn để ghi lại cuộc phiêu lưu của mình với Sherlock Holmes bí ẩn, nghĩ rằng đây có thể là một thử nghiệm thú vị.


Tiếng chuông quen thuộc của căn hộ ở Phố Baker vang khắp căn phòng, báo hiệu sự xuất hiện của một khách hàng mới và tất nhiên là một ca bệnh mới. Một người phụ nữ quẫn trí kể lại hàng loạt vụ trộm trên khắp London – những vụ trộm tưởng chừng như không liên quan nhưng lại tỉ mỉ một cách kỳ lạ.


Khi Holmes đi đi lại lại trong phòng, vẽ tẩu thuốc, đôi mắt xa xăm suy nghĩ, Watson nhân cơ hội này bắt đầu hành trình Chỉ mục Điều tra của mình.


Bắt đầu: “Những vụ trộm tỉ mỉ ở London.”


Watson đã viết ra những chi tiết ban đầu, ngày tháng, tên khách hàng và câu chuyện của cô ấy. Holmes, với sự nhạy bén thường thấy của mình, bắt đầu quan sát nhanh chóng, suy luận sự thật về khách hàng, hoàn cảnh của cô ấy và bản chất của vụ trộm.


Lưu ý: “Tất cả các vụ trộm xảy ra vào lúc hoàng hôn. Không có dấu hiệu cưỡng bức xâm nhập. Mỗi món đồ bị đánh cắp đều có một lịch sử, một câu chuyện.”


Holmes vạch ra kế hoạch đến thăm địa điểm xảy ra vụ trộm.


Nên: “Tham quan dinh thự của Lord Harrington, địa điểm bị trộm đầu tiên.”


Khi họ đi ngang qua những đại sảnh xa hoa trong dinh thự của Lãnh chúa Harrington và sau đó là những con hẻm thiếu ánh sáng ở Đông London, Watson đã ghi lại một cách tỉ mỉ những phát hiện của họ. Mọi dấu chân kỳ dị, mọi tin đồn thì thầm trên đường phố đều tìm được đường vào Danh mục Điều tra của Watson.


Xong: Bộ đôi kết thúc chuyến thăm của họ, thu thập được rất nhiều thông tin, nhưng những mảnh ghép không khớp lắm.


Holmes, trong một khoảnh khắc hiếm hoi, có vẻ bối rối. Các chủ đề của vụ án lơ lửng ngoài tầm với của bộ óc thông minh của anh. Watson với cuốn tạp chí trong tay, gợi ý: “Có lẽ chúng ta nên xem lại những phát hiện của mình?”


Họ ngồi bên lò sưởi, cuốn nhật ký mở ra.


Câu hỏi: “Tại sao chỉ có những vật phẩm có lịch sử? Mối liên hệ là gì?”


Những ngón tay của Holmes gõ lên tay vịn khi Watson lớn tiếng suy nghĩ.


Có lẽ: “Có phải tên trộm đang cố gắng viết lại lịch sử? Hoặc có lẽ đòi lại nó?”


Màn đêm buông xuống, ánh sáng ấm áp của lò sưởi tạo ra những cái bóng nhảy múa trên tường. Giả thuyết “Có thể” đã dẫn họ đi theo dấu vết của những mối thù truyền kiếp trong gia đình, tài sản thừa kế bị mất và lịch sử ẩn giấu của London.


Sự đột phá đến vào lúc bình minh. Một mối liên hệ, trước đây bị bỏ qua, giờ đây đang nhìn chằm chằm vào họ từ các trang của Danh mục Điều tra. Tất cả những món đồ bị đánh cắp đều có nguồn gốc từ một sự kiện duy nhất trong quá khứ của London: Trận hỏa hoạn lớn.


Với sức sống mới, Holmes và Watson theo đuổi vị trí dẫn đầu, đỉnh điểm là một cuộc rượt đuổi gay cấn trên các mái nhà và những con hẻm chật hẹp ở London. Hóa ra, tên trộm là hậu duệ của một gia đình đã mất tất cả trong trận hỏa hoạn và đang cố gắng đòi lại những cổ vật đã mất để khôi phục danh dự cho gia đình mình.


Điểm nổi bật: Watson, khi suy ngẫm về cuộc phiêu lưu của họ, đã đánh dấu việc nhận ra mối liên hệ với Ngọn lửa lớn là bước ngoặt trong vụ án của họ.


Trở lại không gian ấm cúng của Phố Baker, một cảm giác thành tựu tràn ngập không khí. Holmes, sau khi xem qua Danh mục điều tra, nhận xét, "Phương pháp này của anh, Watson, có giá trị của nó."


Watson mỉm cười, viết ra dòng cuối cùng trong đêm. Danh mục Điều tra, ban đầu là một thử nghiệm, giờ đây đã trở thành một phần không thể thiếu trong cuộc phiêu lưu của họ. Khi London chìm vào giấc ngủ, những câu chuyện về Sherlock Holmes và bác sĩ Watson, có cấu trúc và phản ánh, đang chờ chương tiếp theo.

Sherlock Holmes gặp Proglogging

Đối với Marco, một nhà phát triển phần mềm có trụ sở tại San Francisco, buổi sáng thường bắt đầu bằng một tách cà phê nóng hổi và lướt qua những tin tức văn học và công nghệ mới nhất. Là một người hâm mộ cuồng nhiệt của Sherlock Holmes, anh ấy đã mở to mắt khi nhìn thấy dòng tiêu đề về bản thảo mới được phát hiện có một phương pháp độc đáo được gọi là “Chỉ mục điều tra”. Khi đào sâu vào đoạn trích, anh thấy mình bị hấp dẫn không chỉ bởi bí ẩn đang được làm sáng tỏ mà còn bởi cách tiếp cận có hệ thống của Tiến sĩ John Watson để giải quyết nó.


“Danh mục câu hỏi”, với các mục nhập được dẫn dắt bởi động từ và sự phản ánh có cấu trúc, ngay lập tức gây ấn tượng với Marco. Trong thế giới mã vô tận, các phiên gỡ lỗi và thời hạn chặt chẽ, sự hỗn loạn thường khiến bạn cảm thấy choáng ngợp. Liệu phương pháp thời Victoria có thể đưa ra giải pháp cho những thách thức phát triển phần mềm của thế kỷ 21 không?


Quyết tâm tìm hiểu, Marco quyết định áp dụng “Chỉ mục truy vấn” vào quy trình làm việc hàng ngày của mình. Khi anh cân nhắc về một cái tên hiện đại hơn có thể gây được tiếng vang với các chuyên gia am hiểu công nghệ ngày nay, thuật ngữ “Proglogging” xuất hiện trong đầu anh—một từ ghép giữa 'lập trình' và 'ghi nhật ký'.


Được trang bị công cụ mới này, Marco bắt tay vào dự án tiếp theo của mình: triển khai tính năng chế độ tối cho ứng dụng di động. Anh ấy bắt đầu bằng cách trình bày các mục Proglogging của mình.

Chế độ tối


Ước tính: 4 giờ để thực hiện chuyển đổi chế độ tối.


Bắt đầu: Tính năng Chế độ tối.


Lưu ý: Các phương pháp hay nhất đề xuất sử dụng biến CSS và chuyển đổi JavaScript để triển khai chế độ tối.


Nên: Xác định các biến gốc CSS cho chủ đề nhẹ.


Xong.


Nên: Tạo các biến CSS chế độ tối tương ứng.


Xong.


Nên: Triển khai chức năng chuyển đổi JS bằng localStorage để ưu tiên chủ đề.


Xong.


Câu hỏi: Làm thế nào để chuyển đổi suôn sẻ giữa các chế độ?


Lưu ý: Sử dụng chuyển tiếp CSS trên thuộc tính màu.


Nên: Thực hiện chuyển đổi mượt mà giữa chế độ sáng và tối.


Xong.


Thêm: Kiểm tra tính tương thích trên nhiều trình duyệt khác nhau.


Nên: Định vị và tạo kiểu cho nút chuyển đổi chế độ tối ở góc trên bên phải.


Xong.


Giải lao: Nghỉ giải lao 10 phút.


Nên: Kiểm tra việc chuyển đổi trong môi trường cục bộ.


Lưu ý: Chuyển đổi hoạt động nhưng có một chút chậm trễ trong việc thay đổi biểu tượng.


Có thể: Tối ưu hóa việc tải biểu tượng hoặc sử dụng SVG.


Nên: Thay thế các biểu tượng bằng SVG để giải quyết độ trễ.


Xong.


Nên: Đẩy các thay đổi về giai đoạn để nhóm xem xét.


Xong.


Điểm nổi bật: Thay thế các biểu tượng bằng SVG để giải quyết độ trễ là một bước đi quan trọng. Thay đổi này đảm bảo trải nghiệm người dùng mượt mà và nêu bật tầm quan trọng của việc tối ưu hóa hiệu suất.


Ước tính: Điều chỉnh từ 4 giờ thành 3 giờ. Việc triển khai tính năng diễn ra suôn sẻ hơn dự đoán.

Truyền bá

Khi tiến bộ hơn, Marco nhận thấy rằng Proglogging không chỉ cung cấp một danh sách việc cần làm có cấu trúc mà còn cung cấp một bản ghi đầy đủ sắc thái về quá trình suy nghĩ, những thách thức và thành tích của anh ấy. Các mục nhập “Thực hiện” và “Xong” cung cấp một khuôn khổ hành động rõ ràng, trong khi “Ghi chú” và “Câu hỏi” cho phép phản ánh và truy vấn có thể bị mất trong chu kỳ phát triển nhịp độ nhanh.


Bị ấn tượng bởi cách Proglogging nâng cao khả năng tập trung và năng suất của anh ấy, Marco không thể giữ điều đó cho riêng mình. Trong một cuộc họp nhóm, anh ấy đã giới thiệu phương pháp này, trích dẫn nguồn gốc hấp dẫn của nó trong một câu chuyện Sherlock Holmes. Để chứng minh tiện ích của nó, anh đã hướng dẫn họ xem dự án chế độ tối gần đây của mình, cho thấy mỗi mục Proglogging đã giúp anh vượt qua các thách thức kỹ thuật và vòng lặp ra quyết định như thế nào.


Ban đầu còn hoài nghi, các đồng nghiệp của anh không thể bỏ qua sự thành công rõ ràng của tính năng chế độ tối và sự nhiệt tình mới của Marco. Đến cuối tuần, Proglogging đã trở thành phương pháp quản lý công việc được nhóm áp dụng và không lâu sau, các bộ phận khác đã chú ý đến.

Phương pháp Proglogging được tiết lộ

Nhận thấy sự quan tâm ngày càng tăng đối với phương pháp Proglogging của mình, Marco quyết định dành thời gian để trình bày rõ ràng các thành phần và lợi ích cốt lõi của phương pháp này cho nhóm của mình và cuối cùng là cho nhiều đối tượng hơn. Dưới đây là tổng quan về phương pháp Proglogging:

Tổng quan

Proglogging cung cấp một cách tiếp cận có cấu trúc để quản lý và phản ánh nhiệm vụ. Mượn từ các phương pháp ghi nhật ký và ghi nhật ký truyền thống, nó nhấn mạnh việc sử dụng các động từ cụ thể để bắt đầu mỗi mục, đảm bảo sự rõ ràng và mục đích trong tài liệu.

Thành phần chính

  • Tập trung vào một mục nhập : Proglogging ghi lại từng mục suy nghĩ một, hỗ trợ sự rõ ràng và giảm bớt sự choáng ngợp.
  • Hướng dẫn dựa trên động từ : Mỗi mục bắt đầu bằng một động từ được chỉ định, thiết lập mục đích của mục nhập, có thể là một hành động, quan sát hoặc cột mốc quan trọng.

Động từ cốt lõi

  • Lưu ý : Ghi lại những quan sát, hiểu biết sâu sắc hoặc thông tin chung.
  • Do : Chỉ định một hành động hoặc nhiệm vụ sắp xảy ra.
  • Xong : Đánh dấu việc hoàn thành nhiệm vụ từ mục nhập “Thực hiện” trước đó.
  • Câu hỏi : Đánh dấu những điều không chắc chắn hoặc những khu vực cần thăm dò.
  • Có thể : Đề xuất các giải pháp hoặc giả thuyết tiềm năng cho một mối quan ngại đã được ghi nhận.
  • Thêm : Giới thiệu một nhiệm vụ hoặc hành động trong tương lai.
  • Highlight : Nhấn mạnh những thành tựu hoặc thách thức quan trọng.
  • Ước tính : Dự báo thời gian hoặc nỗ lực mà một nhiệm vụ có thể đòi hỏi.
  • Bắt đầu : Báo hiệu sự bắt đầu của một nhiệm vụ hoặc dự án cụ thể.
  • Break : Đánh dấu các khoảng dừng hoặc khoảng thời gian được thực hiện trong quy trình làm việc.

Uyển chuyển

Mặc dù mang tính nền tảng về cấu trúc nhưng Proglogging được thiết kế để có khả năng thích ứng. Khuyến khích điều chỉnh để phù hợp với quy trình làm việc và sở thích của từng cá nhân.

Những lợi ích

  • Tư duy có cấu trúc : Cách tiếp cận dựa trên động từ thúc đẩy tư duy có tổ chức.
  • Sự rõ ràng : Nhiệm vụ, quan sát và phản ánh được phân định rõ ràng.
  • Khả năng thích ứng : Có thể áp dụng trong nhiều tình huống chuyên môn khác nhau, từ phát triển phần mềm đến nghiên cứu học thuật.
  • Suy ngẫm : Khuyến khích sự xem xét nội tâm và học hỏi từ kinh nghiệm.

Cách sử dụng & Ghi chú

  • Bắt đầu với một cuốn sổ tay hoặc công cụ kỹ thuật số. Tạo một mục bắt đầu bằng một động từ đã chọn và làm theo mục đích của nó.
  • Đánh dấu : Thêm Điểm đánh dấu khi bạn cảm thấy đã đạt được thành tích quan trọng hoặc khi điều gì đó không hoạt động như mong đợi.
  • Sau những buổi làm việc kéo dài, hãy xem lại tất cả các mục “Xong”. Chọn một hoặc hai điểm nổi bật để tóm tắt nội dung của buổi học.
  • Xác định vị trí tất cả các tác vụ đang chờ xử lý bằng cách quét các mục “Thêm”.
  • Các động từ cốt lõi là nền tảng. Hãy thoải mái mở rộng hoặc sửa đổi chúng theo nhu cầu cá nhân. Theo thời gian, người dùng phát triển nhịp điệu và phong cách phù hợp với quy trình làm việc của họ.

Di sản tiếp tục

Từ những con phố được chiếu sáng bằng đèn gas ở London thời Victoria đến ánh sáng LED của màn hình máy tính đương đại, hành trình từ 'Chỉ mục điều tra' của Tiến sĩ Watson đến Proglogging của Marco nhấn mạnh sức mạnh lâu dài của tư duy có cấu trúc. Tiến sĩ Watson từng hy vọng phương pháp của ông sẽ hữu ích cho các thế hệ tương lai và thực sự nó đã tìm được cách giải quyết vấn đề hiện đại. Cả xưa và nay, phương pháp này đều là minh chứng cho sự khéo léo của con người, chứng minh rằng những ý tưởng hay không có ngày hết hạn.



Tuyên bố miễn trừ trách nhiệm *: Ôi, tôi ước gì câu chuyện này là sự thật! Nhưng than ôi, câu chuyện bạn đọc về “bản thảo Sherlock Holmes mới được phát hiện” chỉ là hư cấu, được thêu dệt từ sâu trong trí tưởng tượng của tôi. Theo những gì mọi người biết, Ngài Arthur Conan Doyle đã không gửi cho chúng ta bất kỳ điều bất ngờ nào sau khi chết.*


[Câu chuyện tiếp theo trong loạt bài: Khi AI gia nhập nhóm Dev ]