Hi Frank,

On Fri, 7 Apr 2017 15:42:10 -0600
Frank Sandoval <[email protected]> wrote:
> In going through the karaf4 migration guide here
> https://wiki.opendaylight.org/view/Karaf:Step_by_Step_Guide I would
> like to offer some suggestions for improvement.

I’m guessing you’re referring to
https://wiki.opendaylight.org/view/Karaf_4_migration instead, right?

> I don’t know the best protocol for improving the wiki. I might
> directly edit the page I suppose, but would prefer some input before
> I do, as I don’t know all the details (see TBDs below). Here are my
> suggestions:

You could edit it directly, at least for items you’re sure about,
although since notifications don’t work it’s nice to ping the mailing
lists when you make significant changes. Information that’s TBD should
be discussed on the mailing lists, so you’re going about it the right
way (IMO).

> 1) "All projects must complete..”
>       Add “ migration can be considered complete when TDB
>       This requirement is part of the M4 (?) milestone"

Where is that?

> 2) Step 1. Append after last paragraph
>       “one may determine the availability of karaf4 features by
> using the nexus repo manager tool here:
> https://nexus.opendaylight.org/#nexus-search;quick~features-restconf.
> Search for the name of the feature, e.g. features4-restconf
> 
>       Note that you do not need to reference karaf4 assets directly
> in your pom or features files. The maven parent poms in your new
> modules (see below) will resolve the karaf4 versions”

What do you mean by the last two sentences? You *do* need to reference
Karaf 4 assets directly.

Also I’d much rather people used the bug tracker to track things...
(I’ll edit the wiki and mention both the Nexus repository and the bug
tracker.)

> 3) Step 5 “..test your new features in a Karaf 4 distribution..”. 
>        Add “To test features in a local karaf ditto, follow
> directions here:
> https://wiki.opendaylight.org/view/Karaf:Step_by_Step_Guide. See
> section “Test your features for functionality in your local karaf
> distro. 
> 
>       —— the instruction here do not work for me. See  here for
> details
> https://ask.opendaylight.org/question/14453/run-the-opendaylight-karaf-distro-archetype-fails/

It looks like you’re not referencing the appropriate repositories in
your Maven configuration.

> 4) Step 6. This section is not explicit enough to be helpful (at
> least to me). an example should be provided

I’ve clarified that this is optional. There’s an example somewhere in
yangtools or controller, I’ll add a link to it in the wiki.

Regards,

-- 
Stephen Kitt
Principal Software Engineer, Office of Technology
Red Hat

Attachment: pgpa57BWlpIzX.pgp
Description: OpenPGP digital signature

_______________________________________________
Discuss mailing list
[email protected]
https://lists.opendaylight.org/mailman/listinfo/discuss

Reply via email to