Mailing-List: contact user-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
Reply-To: user@hadoop.apache.org
Received-SPF: pass (nike.apache.org: domain of hemanty@thoughtworks.com
 designates 64.18.0.20 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CALQDGEBaRWJzpcLNWHCzQQOE-cqQd5VjoUV-VAPQ1zN=-1xgWQ@mail.gmail.com>
References: 
 <CALQDGEBaRWJzpcLNWHCzQQOE-cqQd5VjoUV-VAPQ1zN=-1xgWQ@mail.gmail.com>
Date: Tue, 8 Jan 2013 20:41:03 +0530
Message-ID: 
 <CAEAKFL9Y4nWjw77jbbZtGSkNWNg3FOB+nZE5g2_9K7LdEttd9g@mail.gmail.com>
Subject: Re: Why the official Hadoop Documents are so messy?
From: Hemanth Yamijala <yhemanth@thoughtworks.com>
To: "user@hadoop.apache.org" <user@hadoop.apache.org>
Content-Type: multipart/alternative; boundary=14dae93a19efb1ade204d2c85a01

--14dae93a19efb1ade204d2c85a01
Content-Type: text/plain; charset=ISO-8859-1

Hi,

I am not sure if your complaint is as much about the changing interfaces as
it is about documentation.

Please note that versions prior to 1.0 did not have stable interfaces as a
major requirement. Not by choice, but because the focus was on seemingly
more important functionality, stability, performance etc. Specifically with
respect to the shell commands you refer to, they were going through the
same evolution. From now, 1.x releases will not change these kind of public
interfaces and Apis.

I don't intend that documentation is unimportant. Just that this might be
less of an issue now, post the 1.x release. As others have mentioned, it
would be great if you can participate to improve documentation by filing or
fixing jiras.

Thanks
Hemanth

On Tuesday, January 8, 2013, javaLee wrote:

> For example,look at the documents about HDFS shell guide:
>
> In 0.17, the prefix of HDFS shell is hadoop dfs:
> http://hadoop.apache.org/docs/r0.17.2/hdfs_shell.html
>
> In 0.19, the prefix of HDFS shell is hadoop fs:
> http://hadoop.apache.org/docs/r0.19.1/hdfs_shell.html#lsr
>
> In 1.0.4,the prefix of HDFS shell is hdfs dfs:
> http://hadoop.apache.org/docs/r1.0.4/file_system_shell.html#ls
>
>
> Reading official Hadoop ducuments is such a suffering.
> As a end user, I am confused...
>

--14dae93a19efb1ade204d2c85a01
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

Hi,<div><br></div>I am not sure if your complaint is as much about the chan=
ging interfaces as it is about documentation.<div><br><div>Please note that=
 versions prior to 1.0 did not have=A0stable interfaces as a major requirem=
ent. Not by choice, but because the=A0focus was=A0on seemingly more importa=
nt functionality, stability, performance etc.=A0Specifically with respect t=
o the shell commands you refer to, they were going through the same evoluti=
on. From now, 1.x releases will not change these kind of public interfaces =
and Apis.</div>
<div><br></div><div>I don&#39;t intend that documentation is unimportant. J=
ust that this might be less of an issue now, post the 1.x release.=A0<span>=
</span>As others have mentioned, it would be great if you can participate t=
o improve documentation by filing or fixing jiras.</div>
<div><br></div><div>Thanks</div><div>Hemanth</div><div><br>On Tuesday, Janu=
ary 8, 2013, javaLee  wrote:<br><blockquote class=3D"gmail_quote" style=3D"=
margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir=3D"=
ltr">
For example,look at the documents about HDFS shell guide:<div><br></div><di=
v>In 0.17, the prefix of HDFS shell is=A0<span style=3D"line-height:15px;fo=
nt-size:14px;font-family:&#39;Courier New&#39;,Courier,monospace">hadoop df=
s:</span></div>

<div><a href=3D"http://hadoop.apache.org/docs/r0.17.2/hdfs_shell.html" targ=
et=3D"_blank">http://hadoop.apache.org/docs/r0.17.2/hdfs_shell.html</a><spa=
n style=3D"line-height:15px;font-size:14px;font-family:&#39;Courier New&#39=
;,Courier,monospace"><br>

</span></div><div><br></div><div>In 0.19, the prefix of HDFS shell is=A0<sp=
an style=3D"line-height:15px;font-size:14px;font-family:&#39;Courier New=
9;,Courier,monospace">hadoop fs:</span></div><div>
<a href=3D"http://hadoop.apache.org/docs/r0.19.1/hdfs_shell.html#lsr" targe=
t=3D"_blank">http://hadoop.apache.org/docs/r0.19.1/hdfs_shell.html#lsr</a><=
span style=3D"line-height:15px;font-size:14px;font-family:&#39;Courier New&=
#39;,Courier,monospace"><br>

</span></div><div><br></div><div>In 1.0.4,the prefix of HDFS shell is=A0<sp=
an style=3D"line-height:15px;font-size:14px;font-family:&#39;Courier New=
9;,Courier,monospace">hdfs dfs:</span></div><div>
<a href=3D"http://hadoop.apache.org/docs/r1.0.4/file_system_shell.html#ls" =
target=3D"_blank">http://hadoop.apache.org/docs/r1.0.4/file_system_shell.ht=
ml#ls</a><span style=3D"line-height:15px;font-size:14px;font-family:&#39;Co=
urier New&#39;,Courier,monospace"><br>

</span></div><div>=A0</div><div><br></div><div>Reading official Hadoop ducu=
ments is such a suffering.</div><div>As a end user, I am confused...</div><=
/div>
</blockquote></div></div>

--14dae93a19efb1ade204d2c85a01--