-
Path: news-archive.icm.edu.pl!news.icm.edu.pl!news.onet.pl!not-for-mail
From: Sebastian Biały <h...@p...onet.pl>
Newsgroups: pl.comp.programming
Subject: Re: mglistość w programowaniu
Date: Wed, 26 May 2010 19:42:02 +0200
Organization: http://onet.pl
Lines: 35
Message-ID: <htjmhf$qs3$1@news.onet.pl>
References: <6...@n...onet.pl>
<htgfd3$c7d$1@node2.news.atman.pl> <htguq4$ft1$2@news.onet.pl>
<9...@l...googlegroups.com>
NNTP-Posting-Host: chello089076168083.chello.pl
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-2; format=flowed
Content-Transfer-Encoding: 8bit
X-Trace: news.onet.pl 1274895727 27523 89.76.168.83 (26 May 2010 17:42:07 GMT)
X-Complaints-To: n...@o...pl
NNTP-Posting-Date: Wed, 26 May 2010 17:42:07 +0000 (UTC)
User-Agent: Mozilla Thunderbird 1.0.6 (Windows/20050716)
X-Accept-Language: en-us, en
In-Reply-To: <9...@l...googlegroups.com>
Xref: news-archive.icm.edu.pl pl.comp.programming:185639
[ ukryj nagłówki ]bartekltg wrote:
>>Podstawa to kod który sie dokumentuje samą jakością bez potrzeby użycia
>>komentarzy ;)
> Juz ktoryś raz spotykam sie z tym zdaniem. Ale to dziala tylko
> lokalnie.
Całkiem sporo projektów obywa sie bez dokumentacji lub ze szczątkową.
Szczególnie jak są refaktorowane ciągle. Utrzymanie dokumentacji jest
zbędną czynnością o ile jest dyscyplina pisania w sposób zrozumiały w
samym języku. Nie jestem przeciwnikiem dokumentacji, ale nie jestem jej
zwolennikiem dla projektów rozwijanych w locie.
> 'Co tak naprawde robi ta funkcja(i 10 innych w niej wykorzystywanych),
> obiekt, kawal programu i po co' sie samo nie skomentuje, jesli jest
> to
> cos nietrywialnego i dluzszego.
Jesli jest dłuzszego to:
a) masz do czynienia z wiedzą specjalistyczną (typu liczenie FFT) i do
zrozumienia wymagane jest coś poza umiejętnością programowania ogólnego.
b) masz spieprzony kod typu funkcje po 4 ekrany ifów, while i forów na 7
poziomach wycinania.
W pozostałych przypadkach mozna kod pociąć na kawałki, zrobić sensowne
nazwy, sensowne wzorce, pisać zgodnie ze sztuką. Jesli masz nietypowy
projekt to trudno o nim dyskutować ogolnie w tym wątku.
> Co z tego, ze widze ladne liczenia splotu probki z jakas funkcją,
> jesli w komentarzu nie jest napisane po co?
Ta wiedza znajduje sie poziom wyżej w metodzie wołającej to coś. Jesli
jej tam nie ma, to masz problem nawet ze wspomaganiem dokumentacją.
Następne wpisy z tego wątku
- 26.05.10 17:46 Sebastian Biały
- 27.05.10 07:13 fir
- 27.05.10 08:44 fir
- 27.05.10 08:55 p...@p...onet.pl
Najnowsze wątki z tej grupy
- Popr. 14. Nauka i Praca Programisty C++ w III Rzeczy (pospolitej)
- Arch. Prog. Nieuprzywilejowanych w pełnej wer. na nowej s. WWW energokod.pl
- 7. Raport Totaliztyczny: Sprawa Qt Group wer. 424
- TCL - problem z escape ostatniego \ w nawiasach {}
- Nauka i Praca Programisty C++ w III Rzeczy (pospolitej)
- testy-wyd-sort - Podsumowanie
- Tworzenie Programów Nieuprzywilejowanych Opartych Na Wtyczkach
- Do czego nadaje się QDockWidget z bibl. Qt?
- 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
Najnowsze wątki
- 2025-02-06 PROGRAM DOPŁAT DO AUT ELEKTRYCZNYCH TO ABSURD. ZA ŚRODKI Z KPO KUPIMY NIEMIECKIE I CHIŃSKIE AUTA
- 2025-02-05 ceny OC
- 2025-02-05 Re: ceny OC
- 2025-02-05 Re: ceny OC
- 2025-02-07 Smar do video
- 2025-02-06 Litowe baterie AA Li/FeS2 a alkaliczne
- 2025-02-07 Gliwice => Business Development Manager - Network and Network Security
- 2025-02-07 Warszawa => System Architect (Java background) <=
- 2025-02-07 Warszawa => System Architect (background deweloperski w Java) <=
- 2025-02-07 Warszawa => Solution Architect (Java background) <=
- 2025-02-07 Gliwice => Ekspert IT (obszar systemów sieciowych) <=
- 2025-02-07 Lublin => Programista Delphi <=
- 2025-02-07 Warszawa => Architekt rozwiązań (doświadczenie w obszarze Java, AWS
- 2025-02-07 Dęblin => Node.js / Fullstack Developer <=
- 2025-02-07 Bieruń => Spedytor Międzynarodowy (handel ładunkami/prowadzenie flo