incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Alan D. Cabrera" <l...@toolazydogs.com>
Subject Re: Require projects to have solid API docs
Date Sun, 11 Oct 2015 20:11:36 GMT
Should != Must


Regards,
Alan

> On Oct 11, 2015, at 11:49 AM, Julian Hyde <jhyde@apache.org> wrote:
> 
> Per [1], "Apache projects should provide sufficient documentation [… so that … ]
users can both make use of our software freely”.
> 
> And: "users of Apache software should be able to find our software, learn how to use
it, and actually apply it to all its common use cases solely by going to the Apache project’s
own website”.
> 
> So: there should be some documentation about how to use the project on the project web
site. That documentation does not need to be in any particular form, such as javadoc.
> 
> Julian
> 
> [1] https://community.apache.org/projectIndependence.html
> 
> 
>> On Oct 11, 2015, at 9:29 AM, Luciano Resende <luckbr1975@gmail.com> wrote:
>> 
>> On Sun, Oct 11, 2015 at 9:15 AM, Ross Gardler <Ross.Gardler@microsoft.com>
>> wrote:
>> 
>>> No. That’s not the role of the foundation. However, ensuring people
>>> contributing to the docs are recognized like any other contributor is the
>>> role of the foundation. Can you help contribute to such docs?
>>> 
>>> 
>>> 
>> +1
>> 
>> -- 
>> Luciano Resende
>> http://people.apache.org/~lresende
>> http://twitter.com/lresende1975
>> http://lresende.blogspot.com/
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Mime
View raw message