Our all loved Release Notes

Ronny Trommer <[email protected]>
Newsgroups gmane.network.opennms.general
Message-ID <[email protected]>
Hello World,

I’m one of the guys who had an earlier life in IT and ran a lot of software for others and release notes where important to me to understand what is the impact and what is the benefit when I do this update.
During the Horizon 21 release I’ve went through the release notes and found a few issues which are confusing to me and makes them hard to read. Just to get some sync, Is this just my world or do you think about it similar?

We use for similar things same words and split issues around. For example:

* New Features
* Epic
* Story
* Enhancement

They all try to express, there is some thing improved and added in the software. I would suggest to add everything which improves the way people solve monitoring problems in one section.
One example is NMS-9365 <http://issues.opennms.org/browse/NMS-9365> which is a new topology provider to visualise your path-outage configuration in the Topology UI. I personally would expect those issues as a new feature.

Dependeny Updates section and Stories
Use a section which are under-the-hood-take-out-the-garbage  / Maintenance issues like updated JNA from version x -> z or Karaf x -> z in a dedicated section. Sure they have impact but it is indirect and often not expressed in the issues.
For example all the Update and upgrade issues for ActiveMQ, Camel and Karaf are in stories and the “Dependency Updates” has not the same but similar entries.

Feedback welcome

------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot

_______________________________________________
Please read the OpenNMS Mailing List FAQ:
http://www.opennms.org/index.php/Mailing_List_FAQ

opennms-discuss mailing list

To *unsubscribe* or change your subscription options, see the bottom of this page:
https://lists.sourceforge.net/lists/listinfo/opennms-discuss
signature.asc (application/pgp-signature, 529 B)
-----BEGIN PGP SIGNATURE-----
Comment: GPGTools - https://gpgtools.org

iQEzBAEBCgAdFiEEShtNBv7sJE0474B0kHWy5QiiRR4FAlnp+9AACgkQkHWy5Qii
RR5gngf+NS1iVceVrh6kTOKXOfWum0Pm8NC/TYEBVXjN6TakNYAWlKL7iNpxXaTR
d/Zn2lV3aIuijAFKRYkVz3yykQSMHbYr7WLG+yK1wlOpP0VieOkrwLfpcGvyeJry
U4imUjAxL6Nx9W6dzhMRpJxDLYdfZkKvq5H/QGFXYSMCj5UupbS9YvkrWM14frQH
Cwjf9OST2zdwqbv0e1mEUEXmu9euG8nJSb5GqT5NdHBLMW3LBZ1fnEyXDFF8cBC4
Pqi76BaGffPYeVIkcFlBokq0qLzCMwprLvw5r6FuY0KiAnLhS8g9mGwU3FbdOiTv
sx26mKMh1nrL0KJvYMV76UpQfoXvlg==
=ihzX
-----END PGP SIGNATURE-----
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.