Article View: pl.comp.programming
Article #217458Re: Narzędzia do wizualizacji systemów Embedded
From: Maciej Sobczak
Date: Mon, 12 Apr 2021 15:58
Date: Mon, 12 Apr 2021 15:58
30 lines
4170 bytes
4170 bytes
> > Ale to nie odpowiada na pytanie, po co napisał książkę. Kod by napisał, taki samokomentujący, i by stykło. Nie? > Równie dobrze mógłbyś pytać, dlaczego nauczyciele prowadzą z uczniami lekcje czytania. Zgadzam się, że na logiczną dyskusję chyba nie ma już szans... > Problem jest podobny do kwestii udostępniania wersji binarnej kompilatora, którego kod źródłowy jest dostępny. ... tak, jestem tego coraz bardziej pewny. Nie ma szans. > Błąd, jaki Ty popełniasz, polega na tym, że ze stwierdzenia, że coś jest dokumentacją, próbujesz wyciągać wniosek, że owo coś jest wyczerpującą albo jedyną potrzebną dokumentacją. Bo właśnie tak to działa w powszechnym odbiorze. W sensie - ktoś, kto nie napisał dokumentacji stwierdza, że przecież jego kod jest tak bardzo samodokumentujący, że już niczego więcej nie trzeba. I tak to zostaje. Więc warto jednak dbać o rozróżnianie pojęć, w przeciwnym razie pogubimy się w ich rozmyciach. Więc zadbajmy o takie rozróżnienie: kod *nie* jest dokumentacją. Może sobie być poezją w jakimś pozainżynierskim kontekście (no chyba że poeci zgłoszą jakiś sprzeciw, np. poczują się obrażeni albo coś), ale nie jest dokumentacją. > Samodokumentujący kod zawiera wszystko, co jest potrzebne do tego, żeby zrozumieć, jak jakiś system działa. "Koń jaki jest, każdy widzi." Wiesz, skąd to zdanie pochodzi? Z bardzo poważnego źródła. Ale jednak z biegiem czasu zaczęliśmy wymagać więcej, więc nawet w tych poważnych źródłach już takich zdań nie ma. > Nie zawiera za to, na przykład, informacji [...] Bo nie jest dokumentacją. > Książka Martina jest (kiepskim bo kiepskim, ale jednak) materiałem, który ma trenować tę umiejętność. Umiejętność czego? Pisania dobrej jakości kodu? No i świetnie, oby więcej takich książek. Nadal jednak kod nie jest dokumentacją. -- Maciej Sobczak * http://www.inspirel.com
Technical Details
Message-ID:
<c788785c-e7d6-4b4f-8348-55dfa7913c39n@googlegroups.com>Path:
mbox-mo1.pugleaf.net!news-archive.icm.edu.pl!news.icm.edu.pl!fu-berlin.de!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mailReferences:
<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> <03382e3f-a8a7-429f-9ab2-d59b48ffc44cn@googlegroups.com> <e54cb8c5-3584-42cc-a75e-e4ed197f4fc8n@googlegroups.com> <4ceb82cc-54f8-49c0-82f7-2a2464ed9f3fn@googlegroups.com> <ef31edca-80b2-45fa-be5c-3b8a3522acedn@googlegroups.com> <3c9199cd-da3a-442a-b9e3-e016ad28b7f8n@googlegroups.com> <ba7bbd79-47e7-4df4-b906-f9642edc0a79n@googlegroups.com> <s4d9qt$blm$1@news.icm.edu.pl> <fbc62c89-79e5-48e0-8dd6-863bfd5c029an@googlegroups.com> <s4p91v$m14$1@news.icm.edu.pl> <64ecbdb5-314e-4322-8a47-a3628667ad8bn@googlegroups.com> <s4q08u$st2$1@news.icm.edu.pl> <9077e026-cb26-4292-8106-3bebefead89cn@googlegroups.com> <4e5f3e96-017d-489c-9e4d-76be9ba0e1f7n@googlegroups.com>Show Full Headers
Complete Article Headers
X-Received: by 2002:a05:620a:1592:: with SMTP id d18mr5723403qkk.329.1618243106240; Mon, 12 Apr 2021 08:58:26 -0700 (PDT) X-Received: by 2002:a05:620a:146a:: with SMTP id j10mr6060380qkl.191.1618243105941; Mon, 12 Apr 2021 08:58:25 -0700 (PDT) Path: mbox-mo1.pugleaf.net!news-archive.icm.edu.pl!news.icm.edu.pl!fu-berlin.de!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mail Newsgroups: pl.comp.programming Date: Mon, 12 Apr 2021 08:58:25 -0700 (PDT) In-Reply-To: <4e5f3e96-017d-489c-9e4d-76be9ba0e1f7n@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> <03382e3f-a8a7-429f-9ab2-d59b48ffc44cn@googlegroups.com> <e54cb8c5-3584-42cc-a75e-e4ed197f4fc8n@googlegroups.com> <4ceb82cc-54f8-49c0-82f7-2a2464ed9f3fn@googlegroups.com> <ef31edca-80b2-45fa-be5c-3b8a3522acedn@googlegroups.com> <3c9199cd-da3a-442a-b9e3-e016ad28b7f8n@googlegroups.com> <ba7bbd79-47e7-4df4-b906-f9642edc0a79n@googlegroups.com> <s4d9qt$blm$1@news.icm.edu.pl> <fbc62c89-79e5-48e0-8dd6-863bfd5c029an@googlegroups.com> <s4p91v$m14$1@news.icm.edu.pl> <64ecbdb5-314e-4322-8a47-a3628667ad8bn@googlegroups.com> <s4q08u$st2$1@news.icm.edu.pl> <9077e026-cb26-4292-8106-3bebefead89cn@googlegroups.com> <4e5f3e96-017d-489c-9e4d-76be9ba0e1f7n@googlegroups.com> User-Agent: G2/1.0 MIME-Version: 1.0 Message-ID: <c788785c-e7d6-4b4f-8348-55dfa7913c39n@googlegroups.com> Subject: Re: Narzędzia do wizualizacji systemów Embedded From: Maciej Sobczak <see.my.homepage@gmail.com> Injection-Date: Mon, 12 Apr 2021 15:58:26 +0000 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit