Tôi là một người khoa học cần ghi lại mã Matlab phức tạp để trao cho nhà phát triển để anh ấy / cô ấy hiểu và lập trình bằng một ngôn ngữ khác. Trước đây, tôi đã sử dụng MS Word (giải thích từng bước chương trình dưới dạng một hàng mới trong bảng) và sau đó là Excel, nhưng không thấy đặc biệt phù hợp để hiển thị mã Matlab của tôi và nhập nhận xét một cách rõ ràng và súc tích cách để tài liệu nó.
Tôi tự hỏi liệu có kỹ thuật nào tốt hơn để giao tiếp mã giả cho nhà phát triển. Bất kỳ phần mềm hiện có (miễn phí?) Hoặc nền tảng khác (ví dụ TextWrangler) đặc biệt phù hợp để cung cấp mã và một số phương pháp để giải thích nó? Hy vọng học hỏi kinh nghiệm của người khác khi làm điều tương tự. Cảm ơn trước.
Sau khi đọc một số bình luận, hãy để tôi cố gắng giải thích thêm ... Tôi giả sử tất cả các nhà phát triển đều biết mã giả, nhưng tôi không cho rằng nhiều người biết mã Matlab. Vì vậy, nếu tôi viết bằng mã giả, tôi có thể bỏ qua mã Matlab (hoặc cung cấp nó để tham khảo, v.v.). Nhưng câu hỏi của tôi thực sự đơn giản hơn ... có phần mềm hay nền tảng nào mà mọi người đã sử dụng trong quá khứ để truyền đạt mã rõ ràng cho nhà phát triển không? Một cái gì đó cho phép người tạo tài liệu dễ dàng mô tả mã? Ví dụ: bạn có thể nhúng mã màu mã phần mềm (một màu cho ý kiến, một màu khác cho các từ dành riêng (nếu, sau đó, khác, v.v.), v.v.), và dọc theo một bên có chỗ để tôi nhập giải thích và tài liệu tham khảo, v.v. Tôi đã thử làm điều này bằng cách sử dụng các sản phẩm của MS, nhưng nghĩ rằng có một ngành công nghiệp của những người cần phải làm điều tương tự,
%bắt đầu một bình luận, và sau đó tôi muốn các bình luận giải thích được thêm vào mã Matlab. Và hãy để tôi trở lại với những câu hỏi về những điều không có ý nghĩa với tôi. Đó sẽ là dễ dàng nhất xung quanh.