Projects

From ProgClub
Revision as of 05:50, 20 August 2011 by John (talk | contribs)
Jump to: navigation, search

__NOTITLE__ This page provides information about ProgClub's open-source computer programming and systems administration projects. For information about ProgClub domains, see Domains. For information about member services, see Services. For information about hosts on the ProgClub network, see Machines. Check out our Forums to get in touch.

Projects

Active projects

Current ProgClub projects are:

Prospective projects

Projects that are only in their planning phase are recorded here. Maybe one day they'll make it to real live active projects, but until then we won't kid ourselves.

  • Cweb, to make a distributed search-engine.

Completed projects

Stuff that's finished. Latest on top.

  • Email, to get email and the mailing lists functional.
  • Pcmail, to provide email administration.
  • Pccipher, to provide compatible encryption libraries for many platforms.
  • Single sign-on, to get user logins working.
  • jj5-bin, to provide administration and utility scripts.
  • Pcview, to provide a web-based svn viewer.
  • Pcldap, to provide LDAP administration.
  • Pcblog, to provide blogs.
  • Pcma, to provide database administration.
  • Kerberos, to provide authentication services.
  • IPSec, to secure the network. Cancelled.

Contributing to ProgClub projects

Contributions to ProgClub projects are covered by the Copyright policy. Generally in order to contribute to a ProgClub project you need to be a member. That is unless you are only planning to contribute to a forum such as the project page on the wiki. Contributions to ProgClub forums are also covered by the Copyright policy. If you are a member and you contribute to a ProgClub project a link to your user page will be added to the Contributors section of the project page. If you contribute to a ProgClub project and your are not a member, then you can optionally include your details (a link to your user page if you have an account on the wiki (you don't need to be a member to have one of these), your email address, or a link to your web-site) along with your name in the Contributors section.

Starting a ProgClub project

If you want to start a project, then: give the project a name, reference the project from this page (put it in the active projects or prospective projects section as appropriate) and copy the Project template to get you started. You might also like to know about how to create your project in pcrepo.

Releasing ProgClub projects

About half of ProgClub's projects have source-code in the subversion repository. Projects that don't have code in the repository don't really need to be released, for them you just have to update the project documentation on the wiki. Projects in svn do need to be released, however. There is a process for releasing projects in svn, and it's detailed on the Subversion page.

In addition to doing a subversion release (which tags the release and updates the latest tag) you might also like to deploy the software. To do a deployment use the project-specific release script in /home/jj5/bin. At the moment that is any of:

  • release-pcwiki, for releasing pcwiki
  • release-pcblog, for releasing pcblog
  • release-pcldap, for releasing pcldap
  • release-pcma, for releasing pcma
  • release-pcview, for releasing pcview
  • release-pccipher, for releasing pccipher

This list will be added to as time goes by, and as there is a need for doing new project releases.

When calling a project-specific release script you pass a single parameter; that being the 'comment', or 'release notes', for the release you are doing. You run these scripts on charity, and after doing the subversion release the web software in /var/www/ is updated appropriately.