Как документировать процедурное программирование?

Question

В колледже я узнал, как использовать UML для документирования приложений OO. В реальном мире мне поручили документировать старую процессуальную программу, существенно пересоздав документы спецификации дизайна, которые пропали без вести.

Существуют ли какие-либо «стандартные» документы или методы, аналогичные UML для документирования процедурного кода? Я уверен, что должно быть что-то, что люди использовали перед UML.

Спасибо!

Answer 1

Да. Блок-схема.

Answer 2

Вы можете использовать PSD (диаграммы структуры процесса) или NSD (Nassi Schneiderman Diagrams). Я должен был изучить его для своих первых уроков программирования, прежде чем погрузиться в OO и Java. Он не охватывает различные аспекты как UML, но его отправной точкой является визуализация процедурной программы.

Answer 3

Помните, что UML означает Unified Modeling Language. Это не только для моделирования отношений объектов, которые, я считаю, являются распространенным заблуждением UML. Он также может использоваться для диаграмм состояний, бизнес-процессов, схем баз данных, ... См.: http://en.wikipedia.org/wiki/Unified_Modeling_Language.

Недавно я использовал IBM Rational Software Architect для преобразования диаграмм состояний в Perl. Но для Perl нам приходилось писать собственные файлы перевода, так как Architect не включал их для Perl.

Но если вы говорите о коде C, у Архитектора есть встроенная функция, позволяющая перепроектировать написанный код в UML-диаграмму. Я использовал эту функцию для Java, и она работает очень хорошо и создает диаграмму объектов. Я раньше не использовал его для C, поэтому я не знаю, превратит ли он его в последовательность, активность или диаграмму состояний.

Вы можете загрузить пробную версию Software Architect и посмотреть, работает ли она для вашего кода.