Skip to content
This repository has been archived by the owner on Feb 4, 2019. It is now read-only.

Added motivation for the bundles module #80

Closed
wants to merge 2 commits into from
Closed

Added motivation for the bundles module #80

wants to merge 2 commits into from

Conversation

nacx
Copy link
Member

@nacx nacx commented Sep 8, 2016

We should try to be very clear about the need for these bundles and why we are providing them here.

@demobox Can you have a look at the wording?


This module provides convenience bundles to let jclouds run properly in OSGi environments.
Some of the bundles contained here are not publicly available, and others are just repackaged
to make them work well with jclouds.
Copy link
Member

@demobox demobox Sep 8, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Interesting question: where is this less likely to go out-of-date, do you think - in a README or as comments in the respective POM files?

As for the wording, I'd only just minor changes and a bit less detail (again, given the risk of this going out of date). Something like:

This module provides bundles required to let jclouds run in OSGi environments. These bundles here may not be publicly available elsewhere, or have been repackaged to work with jclouds.

and then move detailed comments into the POM for each bundle?

@nacx
Copy link
Member Author

nacx commented Sep 8, 2016

where is this less likely to go out-of-date, do you think - in a README or as comments in the respective POM files?

Agree with the approach of putting the details in each pom.xml and keeping the README generic.
Changes done!

@demobox
Copy link
Member

demobox commented Sep 9, 2016

+1 - looks good to me. Thanks, @nacx!

@demobox
Copy link
Member

demobox commented Sep 14, 2016

Merged to master: 522e245. Thanks, Ignasi!

@demobox demobox closed this Sep 14, 2016
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
2 participants