welcome: please sign in

Diff for "HcoopVolunteerTasks"

Differences between revisions 17 and 18
Revision 17 as of 2014-04-01 10:38:28
Size: 6426
Editor: ClintonEbadi
Comment: improve gitweb highlight
Revision 18 as of 2014-04-09 08:54:07
Size: 6685
Editor: MattCarberry
Comment: Parsed Gitweb stuff, Vectorized Hcoop Logo, Made Letterhead
Deletions are marked like this. Additions are marked like this.
Line 26: Line 26:
 * 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.  * --(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
Line 37: Line 37:
 * 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.
 * --(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

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 (tentatively): March 9th

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
  • 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: a Domtool AST <-> Apache AST stage in the compiler to replace the current Apache output code (which consists of a thousands of TextIO.outf calls and is ugly despite working fine)

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)