if we keep any javadocs in the tarball they should just be the user
facing javadocs (wether that includes testapidocs I could go either
way). I'd be in favor of dumping the javadocs entirely from the binary
tarball.

do we know why the apidocs are bigger than our binaries? are we
mistakingly include a source rendition in html again?

We've been a bit spotty on keeping per-release-line javadocs up to
date on the website. To give ourselves an out on that, what about
including a release aritfact that's just a tarball of javadocs?

On Tue, Mar 6, 2018 at 1:33 PM, Andrew Purtell <apurt...@apache.org> wrote:
>> I could make it so we do not build dev doc by default or that we do not
> include it in our bin tarball?
>
> The binary tarball is so huge at this point I think getting the size down
> by pruning javadoc is reasonable, at least in the short term. We have
> javadocs up on our site. They will also be available in Maven and your
> favorite IDE should handle the automatic download and use of javadoc jars.
>
>
> On Tue, Mar 6, 2018 at 11:29 AM, Stack <st...@duboce.net> wrote:
>
>> On the vote thread for hbase-2.0.0-beta-2, it was noted that the bulk of
>> our convenience bin tarball size is test javadoc [1] (~ > 50%). Should our
>> bin tarball include all possible doc both api and dev api for both test and
>> user?
>>
>> I could make it so we do not build dev doc by default or that we do not
>> include it in our bin tarball? What do you all think?
>>
>> Thanks,
>> St.Ack
>>
>>
>> 1.
>> $ cd hbase-2.0.0-beta-2
>> $ du -sh *
>> 256K CHANGES.txt
>> 4.0K LEGAL
>> 128K LICENSE.txt
>> 420K NOTICE.txt
>> 4.0K README.txt
>> 184K bin
>>  40K conf
>> 818M docs
>> 620K hbase-webapps
>> 129M lib
>>
>> $ cd docs/
>> $ du -sh *
>>   0B _chapters
>>  28K acid-semantics.html
>>  11M apache_hbase_reference_guide.pdf
>> 152M apidocs
>>  32K asciidoctor.css
>> 4.0K book
>> 1.9M book.html
>>  16K bulk-loads.html
>>  20K coc.html
>> 4.0K coderay-asciidoctor.css
>> 116K css
>>  36K cygwin.html
>>  20K dependencies.html
>> 272K dependency-convergence.html
>>  16K dependency-info.html
>>  48K dependency-management.html
>> 332M devapidocs
>> 4.0K doap_Hbase.rdf
>>  16K export_control.html
>> 200K fonts
>>  32K hbase.css
>> 2.5M images
>>  28K img
>>  20K index.html
>>  16K integration.html
>>  16K issue-tracking.html
>> 148K js
>>  28K license.html
>>  16K mail-lists.html
>>  20K metrics.html
>>  24K old_news.html
>>  20K plugin-management.html
>>  20K plugins.html
>>  40K poweredbyhbase.html
>>  16K project-info.html
>>  16K project-reports.html
>>  16K project-summary.html
>>  16K pseudo-distributed.html
>>  16K replication.html
>> 372K repo
>>  16K resources.html
>>  16K source-repository.html
>>  16K sponsors.html
>>  24K supportingprojects.html
>>  32K team-list.html
>> 112M testapidocs
>> 205M testdevapidocs
>>
>
>
>
> --
> Best regards,
> Andrew
>
> Words like orphans lost among the crosstalk, meaning torn from truth's
> decrepit hands
>    - A23, Crosstalk

Reply via email to