2 ms·
> Until now, it was a code smell if you need those often. There are exceptions to that, but those are a small minority. Documentation for a system, particularl
by naasking 1y ago
> Until now, it was a code smell if you need those often. There are exceptions to that, but those are a small minority.
Documentation for a system, particularly a rationale, is never a code smell.
> There are ton of Apache projects whose documentation is rather a burden than helpful. They are long and absolutely useless.
LLM prompts are short and to the point by comparison, that's part of my point.
- ruszki 1y ago> is never a code smell /* This changes the sorting of the original list based on the result, when you use a pipeline <- you have an architectural problem - this happens for example in Splunk */ map() /* You need to call these in this exact order, one after another <- your architecture is terrible */ processFirst() processSecond() processThird() /* We did this unusual thing because we hate encapsulation <- obvious paraphrase, and lie, you were just lazy, or you didn't have time */ class A { public static String x } In unrelated code: A.x = "something"; /* We merged these two classes because they looked similar, in the code we have a lot of switches and ifs to differentiate between them, we explained them one-by-one <- do I need to explain this? */ class TwoCompletelyUnrelatedThingsInOne > that's part of my point > The gigantic prompt It was clearly not.*