Nп/п : 34 из 100
 От   : stk                                 2:5075/128        06 сен 23 21:32:48
 К    : Ted Nolan                                             06 сен 23 07:34:02
 Тема : Re: Architecture and best practise questions
----------------------------------------------------------------------------------
                                                                                 
@MSGID:
<667b588f-a017-4de7-904e-ff4bba1eaaafn@googlegroups.com> 12511384
@REPLY: <klrhhmFvgtU1@mid.individual.net>
baf1b17c
@REPLYADDR stk <skuhagen@web.de>
@REPLYTO 2:5075/128 stk
@CHRS: CP866 2
@RFC: 1 0
@RFC-References:
<cfef6de1-b912-42d3-9fa7-5d58e911bd66n@googlegroups.com> 1@dont-email.me> <klrhhmFvgtU1@mid.individual.net>
@RFC-Message-ID:
<667b588f-a017-4de7-904e-ff4bba1eaaafn@googlegroups.com>
@TZUTC: -0700
@PID: G2/1.0
@TID: FIDOGATE-5.12-ge4e8b94
Thanks for the answers so far!

Ted Nolan  schrieb am Mittwoch, 6. September 2023 um 16:44:12 UTC+2:
> I find the Doxygen reports for Tcl projects very useful. You do need 
> to use enough tags to provide the information -- nothing will provide 
> it for you if it`s not there.

 I agree with that, which is why I`m still considering it. It is
so far the best design documentation tool, that I know. I usually
recommend it to younger developers and projects in the company where I work
to document the C-stuff, they do. With well selected sets and a few
followed style-guide rules, that are to be followed, the generated
documentation is a lot better than reading just the code. Especially as it gives
a good overview of the connections between architecture components,
modules and functions.

 Besides using my document/blogging thingy to document itself, I
consideres also to use emacs org-mode and do literate programming. Tried this
many years ago (and it feels to me, that the idea came out of fashion
at least 20 years ago anyway, but that really requires a lot of
discipline and doxygen looks like the easiest and most feature rich solution
still.
--- G2/1.0
 * Origin: usenet.network (2:5075/128)
SEEN-BY: 5001/100 5005/49 5015/255 5019/40 5020/715
848 1042 4441 12000
SEEN-BY: 5030/49 1081 5058/104 5075/128
@PATH: 5075/128 5020/1042 4441



   GoldED+ VK   │                                                 │   09:55:30    
                                                                                
В этой области больше нет сообщений.

Остаться здесь
Перейти к списку сообщений
Перейти к списку эх