[
https://issues.apache.org/jira/browse/FLUME-1406?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13424996#comment-13424996
]
Ralph Goers commented on FLUME-1406:
------------------------------------
Patrick - yes, you would submit a patch from the site directory.
To answer both of you, it is expected that the site will be branched with each
release and the whole site should be included in the source distribution.
Users are more important than developers. Users's generally do not want to
download the sources and build. Users generally prefer to get the documentation
off of the web site. I would suggest you review your own habits. Do you
generally download all the projects you are dependent on to get ahold of their
documentation or do you want access to the documentation on the project's web
site?
I can't quantify this, but I am going to guess that differences in the content
of the guides between releases will have more fixes and updates to
documentation of existing features then it will documentation of new features.
Making these updates available to users on the site quickly is important,
especially any new features can simply include the release they will be
available in.
> Remove documentation from flume trunk
> -------------------------------------
>
> Key: FLUME-1406
> URL: https://issues.apache.org/jira/browse/FLUME-1406
> Project: Flume
> Issue Type: Bug
> Components: Docs
> Affects Versions: v1.3.0
> Environment: All
> Reporter: Ralph Goers
> Attachments: docPatch.txt
>
>
> The user's and developer's guides are part of the web site and should be
> removed from flume trunk
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
