Re: Narzędzia do wizualizacji systemów Embedded

X-Received	by 2002:aed:2983:: with SMTP id o3mr16409372qtd.149.1616861301653; Sat, 27 Mar 2021 09:08:21 -0700 (PDT)
X-Received	by 2002:a37:44e:: with SMTP id 75mr17844414qke.150.1616861301465; Sat, 27 Mar 2021 09:08:21 -0700 (PDT)
Path	csiph.com!news.mixmin.net!proxad.net!feeder1-2.proxad.net!209.85.160.216.MISMATCH!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mail
Newsgroups	pl.comp.programming
Date	Sat, 27 Mar 2021 09:08:21 -0700 (PDT)
In-Reply-To	<47e3881e-b68a-4769-8e09-d2be3159de58n@googlegroups.com>
Injection-Info	google-groups.googlegroups.com; posting-host=213.108.152.51; posting-account=bMuEOQoAAACUUr_ghL3RBIi5neBZ5w_S
NNTP-Posting-Host	213.108.152.51
References	<d1b39f9d-b32f-415a-8054-5383d4c09dc0n@googlegroups.com> <0732d3e3-0bad-4765-8588-b272b9834378n@googlegroups.com> <6c2d0f52-2d8e-4ca6-8766-dd8e7c7ce0b4n@googlegroups.com> <a8045016-bb5b-45ba-8664-d9ad28e91b00n@googlegroups.com> <ae0e5f1f-24c1-42bd-abfa-fd896b169110n@googlegroups.com> <657950da-97f7-420a-a3d0-13597899385en@googlegroups.com> <47e3881e-b68a-4769-8e09-d2be3159de58n@googlegroups.com>
User-Agent	G2/1.0
MIME-Version	1.0
Message-ID	<03382e3f-a8a7-429f-9ab2-d59b48ffc44cn@googlegroups.com> (permalink)
Subject	Re: Narzędzia do wizualizacji systemów Embedded
From	Maciej Sobczak <see.my.homepage@gmail.com>
Injection-Date	Sat, 27 Mar 2021 16:08:21 +0000
Content-Type	text/plain; charset="UTF-8"
Content-Transfer-Encoding	quoted-printable
Xref	csiph.com pl.comp.programming:34419

Show key headers only | View raw

> "Documentation is any communicable material that is used to describe, explain or instruct regarding some attributes of an object, system or procedure, such as its parts, assembly, installation, maintenance and use" 
> 
> Kod źródłowy jest komunikowalny i może być użyty do wyjaśnienia pewnych atrybutów systemu, więc nadal nie rozumiem.

To jest pomysł tej samej warstwy społecznej, która wymyśliła "Working software over comprehensive documentation" i ogólnie tej grupy, która systematycznie nie jest w stanie zrobić sensownej dokumentacji, więc kombinuje jak by tu uzasadnić drobny fakt, że jej po prostu nie ma.

Kod źródłowy oczywiście, że może być komunikowalny. Ale nie jest w stanie wyjaśnić "dlaczego" ani "w jakim celu", czyli nie jest w stanie niczego uzasadnić. Właśnie do tego jest dokumentacja. Oczywiście można zrobić tak:

int maxNumberOfBananasThatTheCustomerXYZAskedForAtTheLastMeeting = 12345;

ale chyba rozumiemy, że taka nazwa to nie jest kod, tylko niewłaściwie użyty komentarz. Czyli dokumentacja. I się pewnie zaraz rozjedzie.
Można też tak:

int maxNumberOfBananas = 12345;

ale bez (rozjeżdżającej się) dokumentacji nie wiemy, dlaczego akurat tyle. A to może być bardzo ważne.
Zrobienie tego samego (w obu wersjach) na diagramie, który posłuży do automatycznego wygenerowania takiego kodu niczego nie zmienia, tylko przenosi problem w inne miejsce w procesie produkcyjnym.

Kod programu nie jest dokumentacją. Diagram może być ilustracją w dokumentacji, ale jeśli diagram służy do generowania kodu, to nie jest. Taki diagram nadal wymaga dokumentacji.

-- 
Maciej Sobczak * http://www.inspirel.com

Back to pl.comp.programming | Previous | Next — Previous in thread | Next in thread | Find similar

Thread

Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-24 04:15 -0700
  Re: Narzędzia do wizualizacji systemów Embedded heby <heby@poczta.onet.pl> - 2021-03-24 13:33 +0100
  Re: Narzędzia do wizualizacji systemów Embedded Adam M <amorawski@magna-power.com> - 2021-03-24 09:28 -0700
    Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-24 12:33 -0700
      Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-25 08:41 -0700
        Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-25 09:18 -0700
          Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-26 09:16 -0700
            Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-26 09:47 -0700
              Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-27 08:39 -0700
        Re: Narzędzia do wizualizacji systemów Embedded Adam M <amorawski@magna-power.com> - 2021-03-25 14:43 -0700
          Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-26 09:41 -0700
            Re: Narzędzia do wizualizacji systemów Embedded Adam M <amorawski@magna-power.com> - 2021-03-26 14:57 -0700
            Re: Narzędzia do wizualizacji systemów Embedded Roman Tyczka <romantyczka@hate.you.spammer> - 2021-03-27 11:46 +0100
              Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-27 08:51 -0700
  Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-24 10:30 -0700
    Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-24 12:45 -0700
      Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-25 08:54 -0700
        Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-25 09:30 -0700
          Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-26 09:26 -0700
            Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-26 09:49 -0700
              Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-27 09:08 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-28 13:40 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-29 09:39 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-30 01:41 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-03-30 14:00 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-03-31 01:42 -0700
                Re: Narzędzia do wizualizacji systemów Embedded slawek <x.y@org.org> - 2021-04-04 23:07 +0200
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-05 10:10 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-05 23:48 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-06 00:21 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-06 09:35 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-06 14:46 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-07 13:07 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-08 03:57 -0700
                Re: Narzędzia do wizualizacji systemów Embedded slawek <x.y@org.org> - 2021-04-09 12:07 +0200
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-09 07:57 -0700
                Re: Narzędzia do wizualizacji systemów Embedded slawek <x.y@org.org> - 2021-04-09 18:44 +0200
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-10 07:26 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-11 14:57 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-12 08:58 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-13 01:32 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-13 08:50 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-13 13:57 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-16 02:26 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciek Godek <godek.maciek@gmail.com> - 2021-04-12 02:45 -0700
                Re: Narzędzia do wizualizacji systemów Embedded Maciej Sobczak <see.my.homepage@gmail.com> - 2021-04-12 09:07 -0700
                Re: Narzędzia do wizualizacji systemów Embedded slawek <x.y@org.org> - 2021-04-04 22:32 +0200
        Re: Narzędzia do wizualizacji systemów Embedded slawek <x.y@org.org> - 2021-04-04 22:26 +0200

csiph-web