OpenNMS

Looks good! 

Hopefully you manage to get all info, since like most developingwork people are happy when they solved a problem late in the evening but forget what they had done in the morning. ;-) 



Op 30 jul. 2010 om 22:25 heeft Mike Danko <mike@...> het volgende geschreven:

> Hey Everyone,
> 
> I'm Mike Danko, I've spent some time around the Fedora Docs community,
> but I spend way too little time there and way too much time dealing
> with OpenNMS and training around it for folks, so I thought I'd throw
> some of what I do to the community.
> 
> I thought I'd propose some changes to the structure and contents of
> the release notes, since it's as good a place to start as any. Just
> requesting some feedback here more than anything. It's all posted on
> the wiki:
> 
> http://www.opennms.org/wiki/User:Mikedanko/Release_Notes_Ideas
> 
> Good? Bad? Terrible?
> 
> ------------------------------------------------------------------------------
> The Palm PDK Hot Apps Program offers developers who use the
> Plug-In Development Kit to bring their C/C++ apps to Palm for a share
> of $1 Million in cash or HP Products. Visit us here for more details:
> http://p.sf.net/sfu/dev2dev-palm
> _______________________________________________
> opennms-docs mailing list
> opennms-docs@...
> https://lists.sourceforge.net/lists/listinfo/opennms-docs

Mike, thanks for this.  The key point - that the release notes should define and then target different audiences in their structure - is a very sound one.

- bc

On 30 Jul 2010, at 3:25 PM, Mike Danko wrote:

> Hey Everyone,
> 
> I'm Mike Danko, I've spent some time around the Fedora Docs community,
> but I spend way too little time there and way too much time dealing
> with OpenNMS and training around it for folks, so I thought I'd throw
> some of what I do to the community.
> 
> I thought I'd propose some changes to the structure and contents of
> the release notes, since it's as good a place to start as any. Just
> requesting some feedback here more than anything. It's all posted on
> the wiki:
> 
> http://www.opennms.org/wiki/User:Mikedanko/Release_Notes_Ideas
> 
> Good? Bad? Terrible?
> 
> ------------------------------------------------------------------------------
> The Palm PDK Hot Apps Program offers developers who use the
> Plug-In Development Kit to bring their C/C++ apps to Palm for a share
> of $1 Million in cash or HP Products. Visit us here for more details:
> http://p.sf.net/sfu/dev2dev-palm
> _______________________________________________
> opennms-docs mailing list
> opennms-docs@...
> https://lists.sourceforge.net/lists/listinfo/opennms-docs

Verstuurd vanaf mijn iPhone

Op 30 jul. 2010 om 22:25 heeft Mike Danko <mike@...> het volgende geschreven:

> Hey Everyone,
> 
> I'm Mike Danko, I've spent some time around the Fedora Docs community,
> but I spend way too little time there and way too much time dealing
> with OpenNMS and training around it for folks, so I thought I'd throw
> some of what I do to the community.
> 
> I thought I'd propose some changes to the structure and contents of
> the release notes, since it's as good a place to start as any. Just
> requesting some feedback here more than anything. It's all posted on
> the wiki:
> 
> http://www.opennms.org/wiki/User:Mikedanko/Release_Notes_Ideas
> 
> Good? Bad? Terrible?
> 
> ------------------------------------------------------------------------------
> The Palm PDK Hot Apps Program offers developers who use the
> Plug-In Development Kit to bring their C/C++ apps to Palm for a share
> of $1 Million in cash or HP Products. Visit us here for more details:
> http://p.sf.net/sfu/dev2dev-palm
> _______________________________________________
> opennms-docs mailing list
> opennms-docs@...
> https://lists.sourceforge.net/lists/listinfo/opennms-docs

I suppose a good question from there might be, what are those groups?
As someone from the .com side, you might be better able to answer that
one. I can think of

Observers (like a NOC)
Administrators (People who run the server/service)
Developers

But that's from my own use case. Ideas here?

On Fri, Jul 30, 2010 at 9:46 PM, Barry T. Campbell <bcampbel@...> wrote:
> Mike, thanks for this.  The key point - that the release notes should define and then target different audiences in their structure - is a very sound one.
>
> - bc
>
> On 30 Jul 2010, at 3:25 PM, Mike Danko wrote:
>
>> Hey Everyone,
>>
>> I'm Mike Danko, I've spent some time around the Fedora Docs community,
>> but I spend way too little time there and way too much time dealing
>> with OpenNMS and training around it for folks, so I thought I'd throw
>> some of what I do to the community.
>>
>> I thought I'd propose some changes to the structure and contents of
>> the release notes, since it's as good a place to start as any. Just
>> requesting some feedback here more than anything. It's all posted on
>> the wiki:
>>
>> http://www.opennms.org/wiki/User:Mikedanko/Release_Notes_Ideas
>>
>> Good? Bad? Terrible?
>>
>> ------------------------------------------------------------------------------
>> The Palm PDK Hot Apps Program offers developers who use the
>> Plug-In Development Kit to bring their C/C++ apps to Palm for a share
>> of $1 Million in cash or HP Products. Visit us here for more details:
>> http://p.sf.net/sfu/dev2dev-palm
>> _______________________________________________
>> opennms-docs mailing list
>> opennms-docs@...
>> https://lists.sourceforge.net/lists/listinfo/opennms-docs
>
>
> ------------------------------------------------------------------------------
> The Palm PDK Hot Apps Program offers developers who use the
> Plug-In Development Kit to bring their C/C++ apps to Palm for a share
> of $1 Million in cash or HP Products. Visit us here for more details:
> http://p.sf.net/sfu/dev2dev-palm
> _______________________________________________
> opennms-docs mailing list
> opennms-docs@...
> https://lists.sourceforge.net/lists/listinfo/opennms-docs
>

> Observers (like a NOC)
> Administrators (People who run the server/service)
> Developers

Yes, I think that's right, and I can't think of a significant likely audience for the docs that isn't listed (if others can, please sing out!)

Most users are network administrators or other folks in the IT department pressed into that role (in other words, experience levels vary, but most of the OpenNMS users I've met and talked with so far were senior, savvy people.)  

NOC/operations staff would be somewhere between observers and users; in the FCAPS model, OpenNMS is routinely used to do F(ault management), A(ccounting) and P(performance); in ITIL-speak, it's Event, Incident and Problem management, plus parts of Availability, Capacity, and Performance Management.

So in terms of users or people who need the system for workflow, that is potentially a wide range.

- bc