On 28/03/2007, at 2:37 AM, Emmanuel Venisse wrote:
I added two development guide in the site, it would be cool if you
can look at it.
The docs look good - thanks for that.
I have some questions about the SCM manager part: it's unclear about
how getScmManager is used. It looks like something you'd get all the
time, but you wouldn't want to start a new plexus container, or
construct and add all the time. Maybe this needs to be altered a bit
to be clearer?
Also, can we add a basic SCM manager to the release? That looks
pretty straight-forward and would take care of the JIRA issue about
creating a POJO facade.
For the commands: might be good to break these out into individual
documents? I imagine there are probable more commands to list and
document too.
Finally, on the site structure:
- I think more detail on the front page, as well as links to the
guides is needed.
- The guides index page is missing one of the links
- need breadcrumbs so that when you go into the plugin site, you can
get back
- we should have the javadoc for the API on the site somewhere
- should we move the SCM space to cwiki since it can be autoexported?
Then we can put the provider matrix and the provider details pages
together and link them in to the site as static pages
- do we need small guides on each provider that outline the
differences/quirks/specific configuration needed?
Just lots of thoughts... not sure how many we need to do for 1.0 :)
wdyt?
- Brett