welcome: please sign in

Diff for "HcoopVolunteerTasks"

Differences between revisions 6 and 20 (spanning 14 versions)
Revision 6 as of 2014-02-19 20:20:32
Size: 1731
Editor: ClintonEbadi
Comment: a few tasks that folks can do without root
Revision 20 as of 2014-04-25 19:06:45
Size: 6730
Editor: ClintonEbadi
Comment: better idea of how to do the apache ast printer
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
The next Hcoop volunteer day is (tentatively): March 9th The next Hcoop volunteer day is: April 27th
Line 5: Line 5:
 * For the technically inclined, the member url directory / location map are generated from DaemonAdmin/Portal using a shell script. You'll need to either update [[http://git.hcoop.net/?p=hcoop/portal.git;a=blob;f=static/gen.sml|the portal code that spits these out]], or come up with another solution (they are easy database queries and could be done in most any language)
     * Bonus points for the first person to use an open street maps widget for the member location summary
 * Volunteeer to be a [[AdminArea|system admin]]
   * In particular, anyone who knows exim or dovecot could help us quite a bit
== Things That Could Be Done ==

=== Improve Documentation ===

The wiki has a number of pages that could use some love, and improving them is something just about anyone can do. Don't be shy with edits, anyone can fix any mistakes that are introduced.
Line 10: Line 12:
 * We need someone with Windows 7 and/or Windows 8 to update the [[MemberManual/TransferringFiles/OpenAFS/Windows|guide to mounting your afs directory]] since the process is different, and you have to use OpenAFS 1.7.x.  * Tag pages CategoryNeedsWork if they clearly need work
 * --(
We need someone with Windows 7 and/or Windows 8 to update the [[MemberManual/TransferringFiles/OpenAFS/Windows|guide to mounting your afs directory]] since the process is different, and you have to use OpenAFS 1.7.x.)-- - Updated
Line 12: Line 15:
 * Mailing list moderators for -discuss, -help, and -sysadmin are needed (right now ClintonEbadi is doing all moderation, and not very regularly)  * In theory [[http://tools.ietf.org/html/rfc5228|sieve]] filters work in `~/.forward` and we should probably document and encourage using sieve in the [[/MemberManual/Email#Filtering|email manual]]
 * --(The OS X openafs documentation is also likely out of date and needs new screenshots)-- - Updated for 10.8

=== Improve Member Interaction ===

We have a [[http://hcoop.net/who|members directory]] featuring any site a member wishes to list, but it's not really being used any more.

 * Add your sites to the [[https://members.hcoop.net/portal/link|member website directory]]!
 * Add your weblog to [[http://planet.hcoop.net/|Planet HCoop]] (by emailing <<MailTo(robin AT hcoop DOT net)>>)
 * It would be nice if the new website had a better member url and location directory. The member url directory / location map are generated from DaemonAdmin/Portal using a shell script. You'll need to either update [[http://git.hcoop.net/?p=hcoop/portal.git;a=blob;f=static/gen.sml|the portal code that spits these out]], or come up with another solution (they are easy database queries and could be done in most any language)
   * Bonus points for the first person to use an open street maps widget for the member location summary
 * --(Recreate the [[http://hcoop.net/css/images/hcoop.gif|hcoop website logo]] as an svg (using LogoDiscussion sources) with layers etc. Changing "A web hosting cooperative" to "Internet Hosting Cooperative" would be nice.)-- - [[http://misc.mattcarberry.hcoop.net/hcoopgraphics/|Vectorized]], and a LaTeX [[http://misc.mattcarberry.hcoop.net/hcoopletterhead/|business letterhead]] made

=== Administration ===

 * We need mailing list moderators for -discuss, -help, and -sysadmin are needed (right now ClintonEbadi is doing all moderation, and not very regularly). Email `hcoop-sysadmin` to volunteer.
Line 14: Line 32:


=== Improve Experience ===

 * --(Someone should write a [[https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration|Thunderbird auto configuration]] file to make setting mail up easier.)-- - Written and installed
 * --(Improve http://git.hcoop.net syntax highlighting)--
   * --(The default list of languages that gitweb highlights is really small. See [[http://git.661346.n2.nabble.com/PATCH-gitweb-Added-syntax-highlight-support-for-golang-td7603339.html|upstream suggestion]]. If you know perl this should be easy: parse the output of `highlight -p` and then generate `%highlight_ext`. An admin can install the script and config change, and keep it up to date with each Debian upgrade. If you're feeling adventurous, you could implement querying `highlight` the Right Way (tm) and try to get the patch merged upstream.)-- - [[https://gist.github.com/mattcarberry/9980724|Script]] written and utilized

=== Programmers Wanted ===

DomTool is a great tool, but it still has rough edges for new users. There are a few easy tasks that could be handled by anyone with even basic familiarity with SML (or as a way to pick up SML).

 * DomTool does not have command line help and instead refers users to the wiki docs. A basic overview of available commands for each tool would increase discoverability
   * It would be straightforward: modify domtool's `src/main-FOO.sml` drivers to spit out useful help on badArgs. Ideally help would be integrated with command processing (domtool just does a `case` over the command line arguments, a type for storing command line arguments would be nice). No real knowledge of domtool is needed, and you can test it without needing to install a virtual hcoop.
 * DomTool could produce "human readable" type errors
   * E.g. "Expected type [Vhost], actual type [Vhost] {Foo}" should hint to the member they need to set the `Foo` domtool environment variable

More difficult DomTool tasks, but still needed:

 * Make domtool easier to build and test locally
   * The makefile doesn't create needed directories during install, there is no testing configuration included, etc.
 * We could support more Apache modules and extend our coverage of existing modules. Doing so is reasonably straightforward (and there are tons of examples in the domtool source). Admin coordination is required to install the new modules.
 * Write a parser to convert `.htaccess` files into domtool configuration
   * For directives we support, domtool could parse htaccess files and include their configuration in a domain. This would make setting up most software easier by only requiring that the htaccess files to be used be listed instead of rewritten.
   * Bonus points for making it more general: Apache domtool actions should generate an Apache AST and use a pretty printer to generate the output text, replacing the current Apache output code (which consists of a thousands of `TextIO.outf` calls and is ugly)

We were previously using the [[https://wiki.debian.org/MeetBot|Debian MeetBot]] to generate meeting minutes for board meetings, but have lost access since RichardDarst is no longer with the coop. Meet bot is written in Python as a supybot plugin. Since we need to set up our own copy, a few new features would be helpful.

 * Commands for taking attendance (e.g. `#here $hcoop-username`)
 * Commands for taking votes
   * Call vote, enter vote, close vote
 * `#action` and friends should recognize hcoop usernames (associated with an IRC nick using the proposed roll call commands) in addition to IRC nicks.

There is a monthly Hcoop volunteer day where we get together on IRC and work on Hcoop tasks. A good place to start is the category Needs Work. Below there's some tasks that are not directly related to the wiki.

The next Hcoop volunteer day is: April 27th

1. Things That Could Be Done

1.1. Improve Documentation

The wiki has a number of pages that could use some love, and improving them is something just about anyone can do. Don't be shy with edits, anyone can fix any mistakes that are introduced.

  • Check out CategoryNeedsWork and revise/clean up wiki pages that have been neglected.

  • Tag pages CategoryNeedsWork if they clearly need work

  • We need someone with Windows 7 and/or Windows 8 to update the guide to mounting your afs directory since the process is different, and you have to use OpenAFS 1.7.x. - Updated

  • Screenshots showing how to whitelist hcoop announcements on gmail would be helpful on MemberManual/GettingStarted/AccountCreated

  • In theory sieve filters work in ~/.forward and we should probably document and encourage using sieve in the email manual

  • The OS X openafs documentation is also likely out of date and needs new screenshots - Updated for 10.8

1.2. Improve Member Interaction

We have a members directory featuring any site a member wishes to list, but it's not really being used any more.

  • Add your sites to the member website directory!

  • Add your weblog to Planet HCoop (by emailing <robin AT hcoop DOT net>)

  • It would be nice if the new website had a better member url and location directory. The member url directory / location map are generated from DaemonAdmin/Portal using a shell script. You'll need to either update the portal code that spits these out, or come up with another solution (they are easy database queries and could be done in most any language)

    • Bonus points for the first person to use an open street maps widget for the member location summary
  • Recreate the hcoop website logo as an svg (using LogoDiscussion sources) with layers etc. Changing "A web hosting cooperative" to "Internet Hosting Cooperative" would be nice. - Vectorized, and a LaTeX business letterhead made

1.3. Administration

  • We need mailing list moderators for -discuss, -help, and -sysadmin are needed (right now ClintonEbadi is doing all moderation, and not very regularly). Email hcoop-sysadmin to volunteer.

    • Workload is light: when you receive a moderation message either kill it or approve it. Can usually be done once per day or less, especially when multiple people are moderating the lists simultaneously.

1.4. Improve Experience

  • Someone should write a Thunderbird auto configuration file to make setting mail up easier. - Written and installed

  • Improve http://git.hcoop.net syntax highlighting

    • The default list of languages that gitweb highlights is really small. See upstream suggestion. If you know perl this should be easy: parse the output of highlight -p and then generate %highlight_ext. An admin can install the script and config change, and keep it up to date with each Debian upgrade. If you're feeling adventurous, you could implement querying highlight the Right Way (tm) and try to get the patch merged upstream. - Script written and utilized

1.5. Programmers Wanted

DomTool is a great tool, but it still has rough edges for new users. There are a few easy tasks that could be handled by anyone with even basic familiarity with SML (or as a way to pick up SML).

  • DomTool does not have command line help and instead refers users to the wiki docs. A basic overview of available commands for each tool would increase discoverability

    • It would be straightforward: modify domtool's src/main-FOO.sml drivers to spit out useful help on badArgs. Ideally help would be integrated with command processing (domtool just does a case over the command line arguments, a type for storing command line arguments would be nice). No real knowledge of domtool is needed, and you can test it without needing to install a virtual hcoop.

  • DomTool could produce "human readable" type errors

    • E.g. "Expected type [Vhost], actual type [Vhost] {Foo}" should hint to the member they need to set the Foo domtool environment variable

More difficult DomTool tasks, but still needed:

  • Make domtool easier to build and test locally
    • The makefile doesn't create needed directories during install, there is no testing configuration included, etc.
  • We could support more Apache modules and extend our coverage of existing modules. Doing so is reasonably straightforward (and there are tons of examples in the domtool source). Admin coordination is required to install the new modules.
  • Write a parser to convert .htaccess files into domtool configuration

    • For directives we support, domtool could parse htaccess files and include their configuration in a domain. This would make setting up most software easier by only requiring that the htaccess files to be used be listed instead of rewritten.
    • Bonus points for making it more general: Apache domtool actions should generate an Apache AST and use a pretty printer to generate the output text, replacing the current Apache output code (which consists of a thousands of TextIO.outf calls and is ugly)

We were previously using the Debian MeetBot to generate meeting minutes for board meetings, but have lost access since RichardDarst is no longer with the coop. Meet bot is written in Python as a supybot plugin. Since we need to set up our own copy, a few new features would be helpful.

  • Commands for taking attendance (e.g. #here $hcoop-username)

  • Commands for taking votes
    • Call vote, enter vote, close vote
  • #action and friends should recognize hcoop usernames (associated with an IRC nick using the proposed roll call commands) in addition to IRC nicks.

HcoopVolunteerTasks (last edited 2021-03-20 18:11:28 by KennethPronovici)