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.


(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

View raw message