This is the source code of the mloss.org website. It was written by the
mloss team, which currently is (in alphabetical order)

Mikio Braun <mikio@cs.tu-berlin.de>
Cheng Soon Ong <chengsoon.ong@inf.ethz.ch>
Soeren Sonnenburg <soeren.sonnenburg@first.fraunhofer.de>


FEATURES

The website contains quite a few features and is also quite specific,
so you may or may not find it useful for your means. The features include:

* a registration system for users of the site
* a database of user submitted software projects
* a rating system for the projects
* a commenting system for the projects
* access-statistics to the projects
* a blog (although articles have to be entered directly through django's
  admin interface)
* a forum
* email notifications for tracking projects and the forum
* a tool which automatically extracts projects in the "machine learning"
  section from CRAN (a repository for packages for the R programming 
  language)

The source code is organized into several sub-directories, so called
"applications". Each directory is organized more or less according to
the django standard, at least containing a definition of the models in
models.py, and of the url mappings in urls.py. If you want to find out
how a specific url is processed, have a look at the urls.py which tell
you which method takes care of the request.

CHANGELOG

mloss.org svn-r482-September-2008

  * Several bugfixes and adjustments related to last minute
    changes in django 1.0:

   - comments now don't require a password
   - search didn't work when returning >10 results
   - added #of subscriptions to list view
   - better interlinking between forum and blog
   - fix comments links in blog and show archive,
   - option to filter by published in JMLR
   - minor style changes
   - change sorting order in forum (new threads first)

mloss.org svn-r470-August-2008

 * Initial Release

LICENSE

The source code is licensed under GPLv3, and incorporates the work of
a number of projects, cf. LICENSE for details.


INSTALLING

This website is built using the django framework
(http://www.djangoproject.com). Refer to that website for general
information about the framework. An online version of a very nice book
on django can be found at http://www.djangobook.com/ . 

Download Django 1.0 or a recent svn snapshot

svn co http://code.djangoproject.com/svn/django/trunk/ Django

and install it via the usual python setup.py install.

To locally test out the mloss.org webpage untar the source and run

python manage.py syncdb
python manage.py runserver

then open http://127.0.0.1:8000 in a web browser and have fun.

In case you want to put things live follow the steps described at
http://www.djangoproject.com/documentation/modpython/.

Sincerely,
	your mloss team.