Brett Porter a écrit :
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.
cool :)
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?
Yes, I wanted to change it today, with an initialize method and the getter that
will return the container.
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.
sure. I'll modify the doc with it.
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.
ok
Finally, on the site structure:
- I think more detail on the front page, as well as links to the guides
is needed.
ok
- The guides index page is missing one of the links
ok
- need breadcrumbs so that when you go into the plugin site, you can get
back
ok
- we should have the javadoc for the API on the site somewhere
sure.
- 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
cwiki? where is it?
- do we need small guides on each provider that outline the
differences/quirks/specific configuration needed?
we already have it, each provider page provide informations but maybe we need
more information
Just lots of thoughts... not sure how many we need to do for 1.0 :)
I'll see what I can do :)
Emmanuel
wdyt?
- Brett