Làm thế nào để bạn viết blog kỹ thuật? [đóng cửa]

Tôi thường đọc rất nhiều về các công cụ liên quan đến lập trình. Khi chủ đề tôi đọc không liên quan trực tiếp đến công việc của tôi, (nói rằng đọc về một số Thuật toán mà tôi không sử dụng trong công việc hàng ngày), tôi quên chúng.

Một cách để củng cố những gì đã học là viết blog. Tôi là người mới bắt đầu viết blog. Khi tôi bắt đầu viết, tôi nhận ra rằng nó rất khó khăn. Thậm chí chỉ đơn giản là sao chép nội dung mất khoảng hai giờ. Viết một suy nghĩ tốt về blog thường mất cả ngày hoặc đôi khi một ngày cuối tuần.

Điều này có bình thường không? Bất kỳ lời khuyên để viết hướng dẫn kỹ thuật / blog kỹ thuật?

Viết đã khó, viết tốt còn khó hơn. Vấn đề của việc cố gắng giải thích một cái gì đó là nó đòi hỏi nhiều kiến ​​thức hơn sau đó chỉ là "kinda know it". Tôi thấy rằng bằng cách viết blog tôi 1. tìm ra các chủ đề liên quan mà tôi cần hiểu, 2. xác định nơi hiểu biết của tôi nông cạn

Đọc qua các slide này http://www.ai.uga.edu/mc/WriteThinkLearn.pdf . Họ giải thích rất nhiều về việc viết (và thậm chí so sánh nó với lập trình)

Mỗi công việc chất lượng đòi hỏi thời gian và nỗ lực. Đó là để được mong đợi.

Một số bài viết trên blog cũ của tôi mất khoảng 3 tuần để hoàn thành. Bạn viết một bản nháp, đọc lại nó, thực hiện các chỉnh sửa cần thiết, quét lại sau đó đọc lại bằng chứng. Nó cần có thời gian.

Một ý tưởng đơn giản làm thế nào để giữ cho mình có động lực. Nếu bạn đang lên kế hoạch cho một cái gì đó lớn, hãy xem xét nếu có ý nghĩa để chia công việc thành 2-3 phần và xuất bản chúng một cách riêng biệt. Các bộ phận cần tất nhiên là hữu ích cho độc giả của bạn. Sau đó, khi họ mất ít thời gian hơn, bạn có nhiều khả năng hoàn thành và hoàn thành công việc một phần.

Một số lời khuyên từ blogger kỹ thuật chưa biết này:

• Xác minh (không chỉ đọc) mã mà bạn đã nhập bằng cách cắt và dán từ bản xem trước vào dòng lệnh hoặc tệp văn bản để chạy. Một số thứ (như kết thúc dòng, thụt lề và ký tự Unicode) có thể bị rối khi chuyển từ trình chỉnh sửa (hoặc trình bao) sang trang web và ngược lại.
• Nhận một con người để kiểm tra chính tả, ngữ pháp và nội dung - Nó cho thấy rằng một số nỗ lực đã làm cho các bài viết chính xác và dễ đọc. Nếu không có ai xung quanh, hãy đảm bảo đọc lại toàn bộ bài viết trước khi xuất bản.
• Nếu nền tảng blog có tô sáng cú pháp , hãy sử dụng nó. Nếu không, gửi mã ở đâu đó có nó và liên kết ở đó.
  • Hệ quả: Giữ các đoạn mã lớn khỏi văn bản bài viết. Điều này hơi mơ hồ, nhưng nếu văn bản giải thích cách một số mã hoạt động thì việc đưa vào một đoạn mã là tốt. Nếu nó trình bày một phần mềm sẽ được tải xuống, tốt hơn là nên tham khảo giao diện web VCS.
• Mỗi bài viết nên được đọc trên chính nó . Tham khảo các bài viết khác là tốt, nhưng đừng cho rằng người đọc đã đọc bất kỳ bài viết nào khác trước bài viết này.
• Sử dụng các định dạng khác ngoài văn bản khi chúng giúp hiểu. Đối với một số thứ, mã là đủ, nhưng đối với một số hình ảnh hoặc thậm chí hoạt hình có thể dễ hiểu hơn nhiều.

Thông thường tôi thấy rằng một bài đăng blog khó khăn mất rất nhiều thời gian vì nó đòi hỏi nghiên cứu; nghiên cứu đó không chỉ giúp bài đăng trên blog của bạn, nhưng nó giúp bạn xây dựng kiến ​​thức cá nhân của riêng bạn trong quá trình này. Như bạn đã nói, bạn đang củng cố kiến ​​thức bằng cách viết bài đăng; bạn cũng đang mở rộng kiến ​​thức của mình. Nắm bắt thời gian nó yêu cầu và coi trọng nó như một kinh nghiệm học tập.

Vâng, nó là bình thường cho việc viết blog kỹ thuật mất thời gian. Đối với tôi, bài viết mất thời gian ngắn nhất (ngắn nhất là một giờ hoặc tối đa một ngày, tùy thuộc vào độ dài). Sau đó, việc chỉnh sửa và viết lại thường mất nhiều thời gian hơn (tối đa hai hoặc thậm chí ba ngày). Một khía cạnh khác được đề cập là cần có thời gian là làm rõ bất kỳ mã mẫu nào. Ngoài ra, tôi muốn dành thời gian tìm các liên kết hỗ trợ cho các chủ đề của mình. Tất cả đều cần có thời gian!

Tôi đoán bạn có thể viết blog kỹ thuật ngay bây giờ Nhưng tôi sẽ đề nghị bạn làm như vậy khi bạn trở thành chuyên gia trong một số lĩnh vực cụ thể. Dành một ngày cuối tuần dường như không quá nhiều thời gian. tất cả phụ thuộc vào sự phức tạp của chủ đề. Tôi đoán những gì tôi đang nói là cốt lõi của ý tưởng shud đến với bạn một cách tự nhiên Việc thực thi có thể (và sẽ) mất nhiều thời gian hơn.

Mọi người đang tìm kiếm một số chuyên gia tư vấn trong một blog .. không phải là một thí nghiệm noobs. nhưng tôi đang nói theo nghĩa chung .. tôi không muốn làm bạn nản lòng khi viết blog. Nhưng hãy ghi nhớ những điều sau đây.

1. Blog của bạn nên nói một cái gì đó mới. Không chỉ thu thập dữ liệu và đưa nó lên blog của riêng bạn

2. Hãy chắc chắn về những gì bạn đang nói, ví dụ như gắn bó với kết quả thực nghiệm mạnh mẽ hoặc các khái niệm hoặc công cụ được thử nghiệm cao mà bạn đã trải nghiệm lần đầu tiên .

3. Hãy sẵn sàng cho những lời chỉ trích.

4. Tìm hiểu các kỹ thuật viết blog (chính xác, ngắn gọn, v.v.)

5. Viết một cái gì đó bởi vì bạn nghĩ rằng nó shud được viết; không phải vì bạn nghĩ nó sẽ được đọc

Các yếu tố của phong cách

Tôi nghĩ rằng kỹ thuật viết tuân theo nhiều quy tắc giống như bất kỳ văn bản nào. Nếu bạn chỉ đọc một cuốn sách về cách viết thì đó phải là cuốn "Những yếu tố của phong cách" cổ điển . Nó đi qua một danh sách những thứ sẽ cải thiện thành phần của bạn, trước hết là (IMO), "Bỏ qua những từ không cần thiết".

Tôi cũng muốn giới thiệu Stephen On " On Writing ". Mặc dù nói nhiều hơn về văn bản hư cấu, nó vẫn chứa nhiều đá quý cho bất kỳ nhà văn tham vọng nào, đặc biệt là trong các lĩnh vực như chỉnh sửa và quá trình viết.

Điều đó được nói rằng điều khó khăn về văn bản kỹ thuật không phải là văn bản thực tế mà là làm rõ suy nghĩ của bạn về điều bạn đang viết. Suy nghĩ lộn xộn dẫn đến văn bản xấu. Viết tốt đòi hỏi bạn phải có một nắm bắt rõ ràng về chủ đề của bạn, đó là lý do tại sao dạy và viết là một cách tuyệt vời để làm chủ một chủ đề.

Chà, tôi mất rất nhiều thời gian để viết bài đăng trên blog, yeah. Tôi thường viết chúng trong vài ngày, hoặc thậm chí để chúng ở dạng bản nháp trong một vài tuần, thỉnh thoảng đọc lại chúng và sửa và chỉnh sửa một chút ở đây và ở đó.

Mất nhiều thời gian, nhưng nếu đó là cái giá để viết một cái gì đó mà tôi không thấy xấu hổ sau đó, thì tôi nghĩ nó đáng giá.