hadoop-common-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Akira AJISAKA <ajisa...@oss.nttdata.co.jp>
Subject Re: Maintaining documentations
Date Tue, 21 Jan 2014 07:47:00 GMT
Hi All,

I wrote several patches for documentation
but most of them are not reviewed.

I want to improve not only the new features but also
the documents. I also think the documents are not
well maintained mainly because :

 * Deprecated commands and parameters still exist.
 * Undocumented command options exist.
 * There're a lot of dead links.

I'll be happy when the above problems are fixed for 2.4 release.
I'm waiting for your advices and reviews!

Thanks Masatake for this proposal.

Regards,
Akira

(2014/01/21 9:03), Masatake Iwasaki wrote:
> Hi developers,
> 
> I wrote a patch for Hadoop's site documentation and would like reviews.
> https://issues.apache.org/jira/browse/HADOOP-10086
> 
> Though I would like to fix documentation further,
> there seems to be many open JIRA issues concerning documents.
> I think the documents is not well maintained now
> because the documentation work does not tend to get
> enough attention of reviewers and commiters.
> 
> In order to impove the situation,
> should I write Wiki pages rather than site documentation
> or refactor whole documentation structure
> in the way like HBase book (http://hbase.apache.org/book/book.html)?
> 
> I will appreciate your advices.
> 
> Regards,
> Masatake Iwasaki
> 


Mime
View raw message