Những rào cản nào phải đối mặt với quá trình phát triển trong việc sử dụng các ngôn ngữ đánh dấu văn bản đơn giản trái ngược với, ví dụ: Microsoft Word? [đóng cửa]

Tôi hiện đang là nhân viên thực tập tại một nhà thầu chính phủ và đang có cảm giác (đáng ghét không thể tránh khỏi) rằng Word là tiêu chuẩn không chính thức trong quy trình phát triển phần mềm.

Định dạng nhị phân của nó làm cho việc cộng tác trên các tài liệu theo cách tôi quen với việc cộng tác trên cơ sở mã rất khó khăn. Việc sử dụng đánh dấu văn bản đơn giản (với các ngôn ngữ như LaTeX, Markdown, ReSturationured Text, v.v. ) cho phép một tài liệu thân thiện với hoạt động tốt với quy trình làm việc bình thường của nhà phát triển. Đối với các nhận xét trong đó ngôn ngữ không hỗ trợ chúng (ví dụ Markdown), có nhiều giải pháp hiện có cho phép nhận xét hợp tác trên các cơ sở mã (ví dụ: GitHub, Bitbucket) có thể dễ dàng áp dụng cho các tệp văn bản thuần túy khác có chứa đánh dấu.

Tôi hiểu rằng cần phải hợp tác với quản lý mù chữ về công nghệ đòi hỏi một số loại giao diện đồ họa cho mọi thứ, nhưng các giao diện như vậy tồn tại cho hầu hết các định dạng này. Ví dụ: LaTeX có một 'ngã ba' các loại được gọi là LyX đặt giao diện đồ họa thành một cú pháp giống như văn bản đơn giản, giống như LaTeX. Tập tin này, mặc dù chủ yếu là đồ họa trong chỉnh sửa, nhưng vẫn thân thiện. (Nó thậm chí còn có các nhận xét kiểu Word.) Nhiều giải pháp trong số này chưa thể được sử dụng thay cho Word và phần lớn là miễn phí hoặc nguồn mở.

Tuy nhiên, chúng tôi sử dụng Word ngay cả đối với tài liệu nội bộ của riêng mình mà không ai khác nhìn thấy. Chúng tôi làm việc với văn bản cho một đoạn quan trọng trong sự nghiệp của chúng tôi --- tại sao tài liệu lại đặc biệt như vậy? Ngoài tầm thường "Chúng tôi không biết gì hơn và bây giờ chúng tôi bị mắc kẹt ở đây", phải có lý do ủng hộ quyết định như vậy. Những thách thức nào đối mặt với quá trình phát triển phần mềm trong việc sử dụng tài liệu văn bản đơn giản thay cho các phương tiện khác để viết tài liệu thông tục hơn (và ít mạnh mẽ hơn)

Vì các lý do sẽ khác nhau, có lẽ nên trả lời riêng cho hai tình huống liên quan chặt chẽ này.

• Sử dụng tài liệu văn bản đơn giản từ đầu
• Di chuyển đến tài liệu văn bản đơn giản theo thời gian

Rất nhiều người tham gia vào quy trình phát triển phần mềm không phải là nhà phát triển và cần khả năng tương tác với tài liệu bất kể. QA / Marketing có nên sử dụng từ và nhà phát triển sử dụng hoàn toàn cái gì khác không? Nó sẽ không nhất quán, nó sẽ thêm một công cụ khác vào chuỗi bảo trì và phần CNTT của một công ty có thể không biết phải làm gì với các tệp, khi họ biết hoàn toàn rõ cách quản lý / duy trì kho lưu trữ tài liệu từ.

Trên hết, nhiều người không phải là nhà phát triển đã dành nhiều năm ở trường đại học bằng Microsoft Word để chuyển sang công việc của họ, thường xuyên có các lớp đào tạo thực tế chỉ về cách sử dụng từ. Họ biết nó tốt hơn nhiều so với các lựa chọn thay thế. Tôi khó có thể nhận ra sự khác biệt khi tôi làm việc trong Open Office so với Word, nhưng khi tôi có chị dâu sử dụng nó để tiết kiệm tiền, một tuần sau đó, chồng cô ấy đã mua Word và tuyên bố "Kể từ khi tôi nhận được tin tôi yêu máy tính xách tay mới của tôi! ". Nghĩ về lối suy nghĩ xáo trộn những thứ như thế, một sự thay đổi nhỏ trong những gì họ đã từng không phải là 'nhẹ' đối với họ.

Từ hiện đại cho phép sự khác biệt phiên bản, chú thích với theo dõi phiên bản và thay đổi hợp nhất là tốt. Nó có thể không đơn giản như mã hợp nhất, nhưng tôi đã thấy nhiều người quản lý dự án làm điều đó một cách dễ dàng, vì vậy chắc chắn các nhà phát triển cũng có thể quản lý để làm điều đó.

Ngoài ra, nó đã trở nên khá phổ biến trong số các nhóm phát triển để làm tài liệu về wiki vì nó quay trở lại biểu diễn văn bản trong khi vẫn đủ đơn giản để những người không phải là nhà phát triển có thể chỉnh sửa.

Cá nhân tôi nghĩ rằng đó là một vấn đề của giáo dục.

Hầu hết mọi người đã bị lừa nghĩ rằng việc sử dụng một công cụ như MS Word giúp việc sản xuất các tài liệu chất lượng dễ dàng hơn, nhưng từ những gì tôi thấy nó thực sự làm cho nó khó hơn. Bạn cuối cùng phải gỡ lỗi định dạng vô tận và chiến đấu với các công cụ của bạn để có được kết quả bạn muốn.

Các công cụ như Scrivener cho phép bạn đến gần hơn một chút với thực tế của tài liệu mà không phải chống lại nó như bạn làm với Word. Một phần là do nhận ra WYSIWYG không thực sự hoạt động tốt.

Trong tổ chức của riêng tôi, càng có nhiều người tôi chuyển sang sử dụng MarkDown cho hầu hết các nhu cầu tài liệu của họ thì càng có nhiều người hạnh phúc hơn và làm việc hiệu quả hơn.

Bạn thực sự có 2 câu hỏi:

Đầu tiên: Tại sao các nhóm không phát triển không sử dụng LaTeX hoặc Markdown khác trong quy trình phát triển phần mềm?

Vấn đề với việc chuyển sang LaTeX là đường cong học tập nhận thức đặc biệt khi bạn giao dịch với người dùng không có kỹ thuật. Người dùng đã biết các định dạng khác và không muốn phải học một phương pháp khác để làm điều tương tự mà họ đang làm. Họ biết rất ít nếu có bất cứ điều gì về cách khác biệt 2 tài liệu và do đó có rất ít giá trị trong việc thay đổi thành định dạng dựa trên văn bản cho chúng. Giải thích cho một người rằng bạn có giải pháp cho một vấn đề mà họ không biết họ có là một việc bán hàng khá khó khăn.

Bạn cũng không thể đánh giá thấp giá trị của động lượng về phía trước. Để chuyển sang một định dạng mới, bạn thực sự phải thuyết phục những người khác trong chuỗi của mình, đó là một việc đáng để đầu tư vào việc học một cái gì đó mới. Ngay cả khi bạn không mong đợi họ chỉnh sửa bất cứ điều gì, cũng cần có thời gian và rất nhiều nỗ lực để chuyển sang định dạng mới khi định dạng hiện có hoạt động (ngay cả khi kém).

Câu hỏi thứ hai: Tại sao nhóm của tôi tiếp tục sử dụng tài liệu từ khi có các tùy chọn tốt hơn và chúng có nhiều khả năng học chúng hơn?

Đây là điều mà bạn nên nói chuyện với những người trong nhóm của bạn. Có thể có những lý do hợp lệ mà họ chọn duy trì tài liệu từ hoặc có thể là vì đó là cách nó luôn được thực hiện.

Có các chi phí liên quan đến bất kỳ thay đổi nào và có thể tốn kém và mất thời gian để chuyển hàng trăm hoặc hàng ngàn tài liệu sang định dạng mới. Nếu bạn sẽ cố gắng thay đổi môi trường của bạn, bạn sẽ phải đưa ra một lý do tại sao bạn nên thay đổi