On Mon, Jul 25, 2011 at 10:27 AM, Torsten Curdt wrote:
>>> Maybe I am working too much in other languages to appreciate the "less
>>> is more" way of coding.
>>> Self descriptive code is less a myth but more a state of mind when
>>> writing that code and documentation.
>>
>> The problem with that
On 7/25/11 8:27 AM, Torsten Curdt wrote:
>>> Maybe I am working too much in other languages to appreciate the "less
>>> is more" way of coding.
>>> Self descriptive code is less a myth but more a state of mind when
>>> writing that code and documentation.
>> The problem with that "state of mind" is
>> Maybe I am working too much in other languages to appreciate the "less
>> is more" way of coding.
>> Self descriptive code is less a myth but more a state of mind when
>> writing that code and documentation.
>
> The problem with that "state of mind" is that unless and until you
> clearly specify
On 7/25/11 6:31 AM, Matt Benson wrote:
> On Mon, Jul 25, 2011 at 5:07 AM, Torsten Curdt wrote:
Good code needs little javadocs.
>>> I disagree strongly.
>>>
>>> The Javadoc should present the public API (and should ideally be
>>> written before the code - i.e. the code implements the docs).
>
On 7/25/11 6:55 AM, Torsten Curdt wrote:
> I am not saying don't use javadocs. It's all about using javadocs effectively.
>
> Forcing javadocs on all methods leads to bloat and noise. Better
> present stellar javadocs on public APIs and document how the library
> works. Having great examples helps
On Mon, Jul 25, 2011 at 9:59 AM, Phil Steitz wrote:
> On 7/25/11 1:36 AM, luc.maison...@free.fr wrote:
>> Hi Jörg,
>>
>> - Mail original -
>> De: "Jörg Schaible"
>> À: dev@commons.apache.org
>> Envoyé: Lundi 25 Juillet 2011 09:19:3
On 7/25/11 1:36 AM, luc.maison...@free.fr wrote:
> Hi Jörg,
>
> - Mail original -
> De: "Jörg Schaible"
> À: dev@commons.apache.org
> Envoyé: Lundi 25 Juillet 2011 09:19:36
> Objet: Re: [math] Inherits doc and @Override
>
>> Hi Phil,
>> Ph
On 7/25/11 1:13 AM, Torsten Curdt wrote:
>> Here's the problem as I see it. Code with no javadoc is bad, bad,
>> bad.
> Good code needs little javadocs.
>
> http://vafer.org/blog/20050323095453/
>
> Good docs and good code over noise - any time.
Ummno.
Without method javadoc, library code
2011/7/22 Arne Ploese :
> Hi,
>
> I saw in the sources serveral /** {@inheritDoc} */ on methods with
> @Override annotation. Javadoc knows to inherit the javadoc of the
> overwritten methos, so there is no need for @inheritDoc.
> If all agree, one could drop this if the code is modified?
For refer
I am not saying don't use javadocs. It's all about using javadocs effectively.
Forcing javadocs on all methods leads to bloat and noise. Better
present stellar javadocs on public APIs and document how the library
works. Having great examples helps a great deal ...but don't (please
don't!) use Ecli
On Mon, Jul 25, 2011 at 5:07 AM, Torsten Curdt wrote:
>>> Good code needs little javadocs.
>>
>> I disagree strongly.
>>
>> The Javadoc should present the public API (and should ideally be
>> written before the code - i.e. the code implements the docs).
>>
>> If the only documentation is the code,
>> Good code needs little javadocs.
>
> I disagree strongly.
>
> The Javadoc should present the public API (and should ideally be
> written before the code - i.e. the code implements the docs).
>
> If the only documentation is the code, it is much harder for users to
> determine how to use the API.
On 25 July 2011 09:13, Torsten Curdt wrote:
>> Here's the problem as I see it. Code with no javadoc is bad, bad,
>> bad.
+1
> Good code needs little javadocs.
I disagree strongly.
The Javadoc should present the public API (and should ideally be
written before the code - i.e. the code implemen
Hi Jörg,
- Mail original -
De: "Jörg Schaible"
À: dev@commons.apache.org
Envoyé: Lundi 25 Juillet 2011 09:19:36
Objet: Re: [math] Inherits doc and @Override
>Hi Phil,
>Phil Steitz wrote:
>> On 7/24/11 10:52 PM, Jörg Schaible wrote:
>>> Hi Phil,
>>&
> Here's the problem as I see it. Code with no javadoc is bad, bad,
> bad.
Good code needs little javadocs.
http://vafer.org/blog/20050323095453/
Good docs and good code over noise - any time.
cheers,
Torsten
-
To unsubscrib
Hi Phil,
Phil Steitz wrote:
> On 7/24/11 10:52 PM, Jörg Schaible wrote:
>> Hi Phil,
>>
>> Phil Steitz wrote:
>>
>>> On 7/24/11 3:13 PM, Gilles Sadowski wrote:
Hello.
> I saw in the sources serveral /** {@inheritDoc} */ on methods with
> @Override annotation. Javadoc knows to inh
On 7/24/11 10:52 PM, Jörg Schaible wrote:
> Hi Phil,
>
> Phil Steitz wrote:
>
>> On 7/24/11 3:13 PM, Gilles Sadowski wrote:
>>> Hello.
>>>
I saw in the sources serveral /** {@inheritDoc} */ on methods with
@Override annotation. Javadoc knows to inherit the javadoc of the
overwritten
Also, the compiler is probably more accurate at keeping inherited
documentation up to date.
On Sun, Jul 24, 2011 at 10:52 PM, Jörg Schaible wrote:
>
> > Right, and including it creates a placeholder to expand on or modify
> > the inherited javadoc. I think we should keep it.
>
> We finally remo
Hi Phil,
Phil Steitz wrote:
> On 7/24/11 3:13 PM, Gilles Sadowski wrote:
>> Hello.
>>
>>> I saw in the sources serveral /** {@inheritDoc} */ on methods with
>>> @Override annotation. Javadoc knows to inherit the javadoc of the
>>> overwritten methos, so there is no need for @inheritDoc.
>>> If al
On 7/24/11 3:13 PM, Gilles Sadowski wrote:
> Hello.
>
>> I saw in the sources serveral /** {@inheritDoc} */ on methods with
>> @Override annotation. Javadoc knows to inherit the javadoc of the
>> overwritten methos, so there is no need for @inheritDoc.
>> If all agree, one could drop this if the co
Hello.
> I saw in the sources serveral /** {@inheritDoc} */ on methods with
> @Override annotation. Javadoc knows to inherit the javadoc of the
> overwritten methos, so there is no need for @inheritDoc.
> If all agree, one could drop this if the code is modified?
CheckStyle complains if there i
Hi,
I saw in the sources serveral /** {@inheritDoc} */ on methods with
@Override annotation. Javadoc knows to inherit the javadoc of the
overwritten methos, so there is no need for @inheritDoc.
If all agree, one could drop this if the code is modified?
-
22 matches
Mail list logo