-
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
- Alg. kompresji LZW
- 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??
Najnowsze wątki
- 2025-02-17 Kraków => MS Dynamics 365BC/NAV Developer <=
- 2025-02-17 Chrzanów => Programista NodeJS <=
- 2025-02-17 Warszawa => Node.js / Fullstack Developer <=
- 2025-02-17 Białystok => System Architect (Java background) <=
- 2025-02-17 Białystok => Solution Architect (Java background) <=
- 2025-02-17 Gliwice => Team Lead / Tribe Lead FrontEnd <=
- 2025-02-17 Gdańsk => PHP Developer <=
- 2025-02-17 Warszawa => Senior ASP.NET Developer <=
- 2025-02-17 Gliwice => Business Development Manager - Network and Network Security
- 2025-02-17 Mińsk Mazowiecki => Area Sales Manager OZE <=
- 2025-02-17 Odśnieżanie samochodu
- 2025-02-17 Katowice => Regionalny Kierownik Sprzedaży (OZE) <=
- 2025-02-17 Dęblin => JavaScript / Node / Fullstack Developer <=
- 2025-02-17 Pompiarze...
- 2025-02-16 PV teraz