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

Reply via email to