-
X-Received: by 2002:a05:620a:e1a:: with SMTP id y26mr32908163qkm.280.1618329024493;
Tue, 13 Apr 2021 08:50:24 -0700 (PDT)
X-Received: by 2002:a05:620a:e1a:: with SMTP id y26mr32908163qkm.280.1618329024493;
Tue, 13 Apr 2021 08:50:24 -0700 (PDT)
Path: news-archive.icm.edu.pl!news.icm.edu.pl!wsisiz.edu.pl!goblin3!goblin.stu.neva.r
u!news.misty.com!border2.nntp.dca1.giganews.com!nntp.giganews.com!news-out.goog
le.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-f
or-mail
Newsgroups: pl.comp.programming
Date: Tue, 13 Apr 2021 08:50:24 -0700 (PDT)
In-Reply-To: <b...@g...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: <d...@g...com>
<0...@g...com>
<6...@g...com>
<a...@g...com>
<a...@g...com>
<6...@g...com>
<4...@g...com>
<0...@g...com>
<e...@g...com>
<4...@g...com>
<e...@g...com>
<3...@g...com>
<b...@g...com>
<s4d9qt$blm$1@news.icm.edu.pl>
<f...@g...com>
<s4p91v$m14$1@news.icm.edu.pl>
<6...@g...com>
<s4q08u$st2$1@news.icm.edu.pl>
<9...@g...com>
<4...@g...com>
<c...@g...com>
<b...@g...com>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <7...@g...com>
Subject: Re: Narzędzia do wizualizacji systemów Embedded
From: Maciej Sobczak <s...@g...com>
Injection-Date: Tue, 13 Apr 2021 15:50:24 +0000
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Lines: 50
Xref: news-archive.icm.edu.pl pl.comp.programming:215473
[ ukryj nagłówki ]> Jeżeli rzeczywiście niczego więcej nie potrzeba, to czas, który nie został
wydatkowany na robienie dokumentacji, to czas zaoszczędzony.
> A jeżeli potrzeba czegoś więcej, to ta potrzeba prędzej czy później da o sobie znać
w jakimś procesie.
> Pisanie dokumentacji po to, żeby była napisana dokumentacja, to kiepski pomysł.
O, i ładnie zmieniliśmy temat. Bo teraz rozmawiamy o tym, czy dokumentacja jest
potrzebna.
Otóż ja nigdzie nie twierdziłem, że zawsze jest potrzebna. Jest cała masa projektów
(i projekcików), gdzie się jej w ogóle nie robi i wszyscy są z tego zadowoleni.
Zwłaszcza ci, którzy akceptują reverse engineering jako metodę poznawczą. Ale już o
tym było.
Więc nie kłócimy się o to, czy dokumentacja ma być, czy ma jej nie być. Kłócimy się o
to, co jest a co nie jest dokumentacją.
(tzn. ja mam coraz mniejszą ochotę się o to przepychać)
> Znów mogę posłużyć się przykładem [...] podzieliłem się nim ze swoim przyjacielem
No widzisz. Jak nie potrzebujesz dokumentacji, to jej nie rób. Do dzielenia się z
przyjacielem lepsze jest piwo, niż dokumentacja.
> > "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 rozumiem.
To było w pierwszej encyklopedii. Autor uznał, że nie ma potrzeby rozpisywać się na
temat konia, bo przecież każdy wie, jak wygląda koń. Takie samodokumentujące się
konie wtedy były. I nikomu to nie przeszkadzało.
> > Bo nie jest dokumentacją.
> Według JAKIEJ definicji?
Według mojej. Serio. Napisałem już tyle na ten jeden temat, że mam dość tłumaczenia
tego i się z tego. Jak nie dotarło, to poległem dydaktyktycznie i pokornie to
przyjmuję. Pocieszam się, że może inni grupowicze skorzystali z tej dyskusji.
Kod nie jest dokumentacją, ja nie umiem (lepiej) tłumaczyć, wypij piwo z
przyjacielem.
--
Maciej Sobczak * http://www.inspirel.com
Następne wpisy z tego wątku
- 13.04.21 22:57 Maciek Godek
- 16.04.21 11:26 Maciek Godek
Najnowsze wątki z tej grupy
- Bibl. Qt jest sztucznie ograniczona - jest nieprzydatna do celów komercyjnych
- Co sciaga kretynow
- AEiC 2024 - Ada-Europe conference - Deadlines Approaching
- Jakie są dobre zasady programowania programów opartych na wtyczkach?
- sprawdzanie słów kluczowych dot. zła
- Re: W czym sie teraz pisze programy??
- Re: (PDF) Surgical Pathology of Non-neoplastic Gastrointestinal Diseases by Lizhi Zhang
- CfC 28th Ada-Europe Int. Conf. Reliable Software Technologies
- Młodzi programiści i tajna policja
- Ada 2022 Language Reference Manual to be Published by Springer
- Press Release - AEiC 2023, Ada-Europe Reliable Softw. Technol.
- Ada-Europe - AEiC 2023 early registration deadline approaching
- Ada-Europe Int.Conf. Reliable Software Technologies, AEiC 2023
- Ile cykli zajmuje mnożenie liczb 64-bitowych?
- Ideologia Polskiego Programisty wer.3
Najnowsze wątki
- 2024-05-05 przeźroczyste koszulki
- 2024-05-05 Re: Win 10/11 nie lubi OKI
- 2024-05-05 Programator czasowy TUYA.
- 2024-05-05 Na tej Chmurce uciekły mi 2 posty
- 2024-05-05 Jakiś Volume
- 2024-05-05 Komin do wiaty
- 2024-05-04 Bonusowe pytanie rozliczenie sie z elektrownia - fotowoltaika.
- 2024-05-04 Ujawnienie porady prawnej prokuraturze
- 2024-05-04 Jaką kamerkę samochodową polecacie?
- 2024-05-04 Warszawa => Spedytor międzynarodowy <=
- 2024-05-04 Warszawa => Mid PHP Developer (Laravel) <=
- 2024-05-04 Warszawa => Inżynier DevOps (projekt JP) <=
- 2024-05-04 Gdańsk => Specjalista ds. Sprzedaży <=
- 2024-05-04 Łódź => Business Development Manager - obszar bezpieczeństwa IT <=
- 2024-05-04 Warszawa => Interactive/Experience Designer <=