On 6/8/06, Allen Gilliland <[EMAIL PROTECTED]> wrote:
Dave Johnson wrote:
>> docs/*
>
> I strongly object to removing the docs from the webapp. The docs for
> the current version of the app should be made available within the
> app. The should be moved to roller-ui so they are not polluting the
> URL space.
I am fine with that. In general I think the issue with docs is a coin
flip for me. On one hand I definitely see the benefits of including the
docs in a browsable location of the app with each release. However, on
the flip side there is something to be said for not polluting the webapp
with things that people don't really need, we can package the docs in
the bundle and not in the webapp and if people want to move them into
the app then they can do so. there is also something to be said for
maintaining online documentation in a central location like
roller.apache.org/docs and not duplicating those docs over and over again.
It's a lot easier for the user to simply click on the docs link and see the
user guide than it is for them to go to our website and search around for
the docs that correspond to the version of Roller that they are using.
i consider the "release" and the
"webapp" to be 2 different things. the webapp is just what gets run in
the container, i.e. what you get in build/roller. the release is the
webapp plus whatever else we think is useful, typically like legal
notices, docs, examples, plugins/addons, etc.
Right now we just ship two things 1) the self contained webapp and
2) the source release. To run Roller all you need is #1. I don't see a
compelling reason to change that yet. Plus, I believe that docs and
license/notices should be embedded in the app.
- Dave
