README.md in concen-0.2.6 vs README.md in concen-0.2.7
- old
+ new
@@ -1,39 +1,31 @@
# Concen
-Concen is a Rails Engine for controlling and monitoring a Rails application from a web interface. It includes content capturing system, real-time traffic monitoring, and real-time performance monitoring. It's built to be flexible and customizable to fit custom needs.
+Concen is a Rails Engine for managing and monitoring a Rails application from a web interface. It includes content management system, real-time traffic monitoring, and real-time performance monitoring. It's built to be flexible and customizable to fit custom needs.
## Requirements
- **Rails 3.1**. Concen only supports Rails 3.1 application.
-- **MongoDB 1.8.x**. All data are stored in MongoDB database, including all of the files uploaded (stored in GridFS).
-- **Typekit** (optional). Concen uses [Proxima Nova](http://typekit.com/fonts/proxima-nova) font. This font can be obtained from Typekit.
+- **MongoDB 2.0.x**. All data are stored in MongoDB database, including all of the files uploaded (stored in GridFS).
+- **Typekit** (optional). Concen uses [Proxima Nova](http://typekit.com/fonts/proxima-nova) font. This font can be easily obtained from Typekit.
## Installation
Add the following to the Gemfile of a Rails application.
- gem "concen", "~> 0.1"
+ gem "concen", "~> 0.2.6"
-Concen uses Compass to generate its stylesheets so include Compass' gem in assets group in the Gemfile. If you face a problem when precompiling the assets, it's most likely because Compass' gem isn't included in the Gemfile.
-
- group :assets do
- gem "compass", "~> 0.12.alpha"
- end
-
Run the rake task to setup Concen.
rake concen:setup
Follow the brief guide upon completion of the rake task.
-## Content Capturing System
+## Content Management System
-Any Rails application will require static contents at some point or another. Many of us will just write those contents in the Rails views. Quite recently I have begun to think that this is a wrong approach. We don't need a full blown Content Management System (CMS) to handle them. We rather need a Content Capturing System (CCS). Most of these contents might not come from you, but other people. Most often, there are several people involved. A CCS does not focus in managing content. It focuses on capturing content from the content creators.
+Most of the Rails applications will likely need a Content Management System (CMS) at some point or another. It could be for a blog or just static content. For the static content, it is very simple to write in the Rails views. If the programmer was the writer himself, this approach is very straight forward. But often the writers are not programmers. Concen allows the writers to write the content easily from day one. Then, programmers can programatically include this content in the Rails views. The CMS itself has a simple text editor and a simple file uploader. Content can be represented in the form of text and files (images, videos, sounds, etc).
-The CCS itself has a simple text editor and a simple file uploader. Contents these days are not only in the form of text but also images, audios and videos. CCS offers a quick and easy way to capture all of them.
-
Back to the Rails application, the developer/programmer could place these contents in the views. For example with the following method call.
Concen::Page.published.desc(:publish_time)
The above method call will return all the contents that have been marked as published and sort them by publish time. In this fashion, Rails views could be free from any static content.
@@ -45,13 +37,13 @@
Generating static content should not be performed for every request because it is expensive. Concen does not have a mechanism of caching. However it is very simple in Rails to cache a page. You don't have to use Rails page caching mechanism. You simply need to set the proper Cache-Control header. For example the following code will cache a page for 5 minutes in any reverse proxy and in the client browser. You can add a [Rack Cache](http://rtomayko.github.com/rack-cache/) or setup [Nginx reverse proxy cache](http://wiki.nginx.org/HttpProxyModule#proxy_cache) easily or even [Varnish](http://varnish-cache.org/) when the time comes.
expires_in 5.minutes, :public => true
fresh_when :etag => @article, :public => true
-## Writing Style for Content Capturing System
+## Writing Style for Content Management System
-There are no rules enforced for writing content with Concen CCS. But there are certain writing styles that will help writing content more manageable and convenient.
+There are no rules enforced for writing content in the CMS. But there are certain writing styles that will help writing content more convenient and manageable.
Here is an example with single-segment content.
Title: 1984
@@ -132,51 +124,56 @@
If you have used Concen for any of your websites and would like to be listed here. Please send me a message.
## Versions
+- **0.2.7**:
+ - Better time formatting
+ - Show full name in user list
+ - Update Redcarpet to version 2.1.0
+
- **0.2.6**:
- - Update Redcarpet to version 2.0.0.
+ - Update Redcarpet to version 2.0.0
- **0.2.5**:
- - Temporary fix for Redcarpet's smartypants extension.
- - Minor color changes.
- - Remove Compass dependency.
- - Remove Haml dependency.
+ - Temporary fix for Redcarpet's smartypants extension
+ - Minor color changes
+ - Remove Compass dependency
+ - Remove Haml dependency
- **0.2.4**:
- - Set Mongoid dependency at "~> 2.2" for flexibility.
- - The fields for Concen::Response are now predefined.
+ - Set Mongoid dependency at "~> 2.2" for flexibility
+ - The fields for Concen::Response are now predefined
- **0.2.3**:
- - Update Mongoid version (2.2.2).
- - UI design enhancements.
- - Tests are now using MiniTest.
- - Add ancestor_slugs field for Page model.
- - Page is given a default title if none is present.
+ - Update Mongoid version (2.2.2)
+ - UI design enhancements
+ - Tests are now using MiniTest
+ - Add ancestor_slugs field for Page model
+ - Page is given a default title if none is present
- **0.2.2**:
- - Update Chronic gem dependency.
- - Fix set_position and reset_position.
+ - Update Chronic gem dependency
+ - Fix set_position and reset_position
- **0.2.1**:
- - Minor bug fixes.
- - Update jQuery to 1.6.4.
- - Update Redcarpet to 2.0.0b5 (fixes for inline HTML bug in Markdown parser).
+ - Minor bug fixes
+ - Update jQuery to 1.6.4
+ - Update Redcarpet to 2.0.0b5 (fixes for inline HTML bug in Markdown parser)
- **0.2.0**:
- - Rails 3.1 compatibility.
+ - Rails 3.1 compatibility
- **0.1.7**:
- - Fix installation error when using Ruby 1.8.7.
+ - Fix installation error when using Ruby 1.8.7
- **0.1.6**:
- Fix gemspec encoding issue.
@@ -184,25 +181,25 @@
- A better approach of handling slug. Slug by default is generated from title. It can then be overwritten by specifying "Slug" in metadata declaration (from the text editor).
- **0.1.4**:
- - Simpler setup process (only in 2 steps).
- - Brief guide is available upon the completion of setup.
- - Fix a bug in file path drag and drop function.
+ - Simpler setup process (only in 2 steps)
+ - Brief guide is available upon the completion of setup
+ - Fix a bug in file path drag and drop function
-- **0.1.3**: Minor bug fixes.
+- **0.1.3**: Minor bug fixes
-- **0.1.2**: Minor bug fixes.
+- **0.1.2**: Minor bug fixes
-- **0.1.1**: Minor bug fixes.
+- **0.1.1**: Minor bug fixes
-- **0.1**: Initial release.
+- **0.1**: Initial release
## Upcoming Features
-- Time range selection in traffic statistics.
-- Time range selection in performance statistics.
+- Time range selection in traffic statistics
+- Time range selection in performance statistics
## License
Copyright © 2011 Steve Randy Tantra