On Tue, Feb 10, 2009 at 08:58:21AM +0100, Simon Hoerder wrote:
> I'm Simon, a student of IT security at Ruhr-University Bochum and a
> happy BB owner, and I'd like to help with Barry development.
Hi Simon,
Welcome to Barry!
> To get started, I'd like to help with documentation and in your todo
> list I've found that you want to get the documentation in a wiki. I
> suppose it's the Sourceforge Wiki you're talking about? If so, it would
> be helpful if you assign me ('shoerder' on sourceforge) as a 'member' so
> that I can edit the wiki pages. What would be more important:
> Transferring existing documentation into the wiki or creating new docs
> on the USB protocol? (Hints are always appreciated.)
This is great. Thank you for your offer.
The reason the wiki hasn't gotten off the ground so far is due to a number
of reasons. The wiki we settle on must be able to:
- keep indefinite history
- track who contributes (only registered users can write to it)
- send email notifications to anyone who is interested, about
changes and edits, and let this setting be global,
or on a per page basis
- allow full backups of the complete edit history
Basically, I don't want to have people's work lost in a poor wiki choice, and
I want it to be as open (from a change history point of view) as possible,
to me, as well as the community. The requirement for registered sourceforge
users (or registered wiki users, however that's done) is so that copyright
of content can be attributed.
So far, the default Sourceforge wiki has not satisfied me that it comes close
to handling this, but Sourceforge has been adding features called Hosted Apps,
and I believe their Hosted wiki application has promise.
So if you want, you could really help me out by reading up on the Sourceforge
Hosted App Wiki, and see if it can accomplish the above requirements.
Let me know what permissions you need to contribute to the wiki, or whether
I need to apply to the sourceforge admins to get it setup.
Alternately.... all the current documentation is located at:
http://www.netdirect.ca/software/packages/barry/
All of this documentation is in HTML / PHP format and is in the CVS / git
tree itself. You can submit patches directly to the CVS tree, and I'll
update the website.
This documentation is mostly coding, building, and user documentation.
It has very little in the way of protocol docs, and what is there is
out of date.
I fully expect that general user documentation will remain on the
netdirect.ca site. As for USB protocol docs, they can go there too,
or in a wiki. And who knows? The wiki might flourish beyond my expectations
if we get beyond the setup and admin issues.
Jump in wherever you like. :-)
Thanks,
- Chris
------------------------------------------------------------------------------
Open Source Business Conference (OSBC), March 24-25, 2009, San Francisco, CA
-OSBC tackles the biggest issue in open source: Open Sourcing the Enterprise
-Strategies to boost innovation and cut costs with open source participation
-Receive a $600 discount off the registration fee with the source code: SFAD
http://p.sf.net/sfu/XcvMzF8H
_______________________________________________
Barry-devel mailing list
Barry-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/barry-devel
