##### General Information

- Overview
- Features
- Specification
- Getting Started
- Howto Build Turbine
- Changes

##### Documentation

- Services
- Howtos
- Wiki
- JavaDocs

##### Development

- Proposals
- How To Help
- Todo

##### Project Documentation

- Project Information
  - About
  - Continuous Integration
  - Dependencies
  - Issue Tracking
  - Mailing Lists
  - Plugin Management
  - Project License
  - Project Plugins
  - Project Summary
  - Project Team
  - Source Repository
- Project Reports

##### Apache

- Apache Website
- License
- How the ASF works
- Sponsorship
- Thanks
- Security

## What is Apache Turbine?

Apache Turbine™ is a servlet based framework that allows experienced Java developers to quickly build secure web applications. Parts of Turbine can also be used independently of the web portion of Turbine as well. In other words, we strive to make portions of Turbine easily available for use in other applications.

A web based application is an application where users use their favorite web browser in order to access secure business logic.

A couple example web applications that can benefit from using this framework include e-commerce shopping cart systems, Yahoo style link conservatories and project / bug / issue tracking systems as well as cool XML integration applications like Jetspeed.

A platform for building applications, not just running them.

Many commercial (and non-commercial!) software companies will attempt to sell you an "Application Server", but what few people realize is that it is only half of the battle to creating a web application. There is often quite a lot of code that your engineers end up re-inventing the wheel with or grabbing various packages from all over the net with various licenses that you may or may not agree to.

The point of Turbine is to collect that code into one location and make it easy to create re-usable components (such as ParameterParsing, Database Connection Pools, Job Scheduling, GlobalCaches, integration with other tools such as Torque, Velocity, etc...) all under a license (Apache) that allows you to create useful websites for your customers without worrying about viral code. Turbine is not the end all answer, but it sure is a nice way to make your development life easier.

This framework has an intended audience that is directed at web engineers, not necessarily the web designers. By using this framework, it is possible for the web engineers to build intuitive high level systems for the web designers to use, but the low level framework is strictly for web engineers. Turbine is not a web application server. It is a tool for building web applications. Your servlet engine is your application server and the application that you develop using this framework is your web application.

Integration with Velocity is well defined and makes doing applications using these tools painless for both the developers and the web designers!

Turbine can be integrated with existing Velocity, Java Server Pages (JSP) and Cocoon technologies by specially creating Screens that use Services to parse templates. Screens can also be created to read files from other websites as well as off disk. This makes it easy to have designers simply put the body of a page on disk and Turbine can serve these files when requested. All of this is described in more detail in the documentation section below.

The reason why Turbine works so well is because it applies object oriented principles to the entire process of building a complex secure web application. We try to follow the Model 2 methodology yet expand on it to encompass "View" techologies other than just JSP as well as more mature methodologies such as Action Event handling. Turbine is consided as Model 2 + 1. :-) Please see the discussion of Model 2+1 for more information.

This all sounds like a bunch of marketing talk, but in reality, Turbine has been developed by developers for developers. We are not trying to sell you something that does not really work, instead we are trying to solve (or do something about) the problems that our fellow developers keep having over and over again. Come be a part of the revolution!

## How do I contribute, give feedback, fix bugs and so on?

We really need and appreciate any contributions you can give. This includes documentation help, source code and feedback. Discussion about changes should come in the form of source code and/or very detailed and well thought out constructive feedback. The How To Help document has details and hints how to get engaged with Turbine Development. We also have a To Do document that describes work to do with the current Turbine code.

- We have a Turbine mailing lists for discussion.
- You can also access the Turbine SVN repository