Skip to content

Commit 8007d85

Browse files
author
Lars Janssen
committed
Updated README to new template, added CONTRIBUTING
1 parent a3773c8 commit 8007d85

File tree

2 files changed

+36
-49
lines changed

2 files changed

+36
-49
lines changed

CONTRIBUTING.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
Contributing
2+
------------
3+
4+
Symfony2 CMF is an open source, community-driven project. We follow the same
5+
guidelines as core Symfony2. If you'd like to contribute, please read the
6+
[Contributing Code][1] part of the documentation. If you're submitting a pull
7+
request, please follow the guidelines in the [Submitting a Patch][2] section
8+
and use the [Pull Request Template][3].
9+
10+
[1]: http://symfony.com/doc/current/contributing/code/index.html
11+
[2]: http://symfony.com/doc/current/contributing/code/patches.html#check-list
12+
[3]: http://symfony.com/doc/current/contributing/code/patches.html#make-a-pull-request

README.md

Lines changed: 24 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,40 @@
1-
# Symfony CMF Standard Edition [![Build Status](https://secure.travis-ci.org/symfony-cmf/symfony-cmf-standard.png?branch=master)](http://travis-ci.org/symfony-cmf/symfony-cmf-standard)
1+
# Symfony CMF Standard Edition
22

3-
### You will need:
4-
* Git 1.6+
5-
* PHP 5.3.3+
6-
* php5-intl
7-
* phpunit 3.6+ (optional)
8-
* composer
3+
[![Build Status](https://secure.travis-ci.org/symfony-cmf/symfony-cmf-standard.png)](http://travis-ci.org/symfony-cmf/symfony-cmf-standard)
4+
[![Latest Stable Version](https://poser.pugx.org/symfony-cmf/symfony-cmf-standard/version.png)](https://packagist.org/packages/symfony-cmf/symfony-cmf-standard)
5+
[![Total Downloads](https://poser.pugx.org/symfony-cmf/symfony-cmf-standard/d/total.png)](https://packagist.org/packages/symfony-cmf/symfony-cmf-standard)
96

10-
## Get the code
7+
This bundle is part of the [Symfony Content Management Framework (CMF)](http://cmf.symfony.com/)
8+
and licensed under the [MIT License](LICENSE).
119

10+
The Symfony CMF Standard Edition (SE) is a distribution of the CMF based on all
11+
the main components needed for most common use cases.
1212

13-
curl -s http://getcomposer.org/installer | php --
14-
php composer.phar create-project --stability dev symfony-cmf/standard-edition path/to/install
13+
## Requirements
1514

16-
This will fetch the main project and all it's dependencies.
15+
* Symfony 2.3.x
16+
* See also the `require` section of [composer.json](composer.json)
1717

18-
The next step is to setup the database, if you want to use Sqlite as your database backend just go ahead and run the following:
1918

20-
app/console doctrine:database:create
21-
app/console doctrine:phpcr:init:dbal
22-
app/console doctrine:phpcr:repository:init
23-
app/console doctrine:phpcr:fixtures:load
19+
## Documentation
2420

25-
If you prefer to use another database backend, for example MySQL, run the Symfony configurator (point your browser
26-
to /web/config.php) or set your database connection parameters in app/config/parameters.yml. Make sure you leave
27-
the 'database_path' property at 'null' in order to use another driver than SQLite. Leaving the field blank in the
28-
web-configurator should set it to 'null'.
21+
For the install guide and reference, see:
2922

30-
## Access by web browser
23+
* [symfony-cmf-standard documentation](http://symfony.com/doc/master/cmf/getting_started/installing_symfony_cmf.html)
3124

32-
Create an apache virtual host entry along the lines of
25+
See also:
3326

34-
<Virtualhost *:80>
35-
Servername symfony-cmf-standard.lo
36-
DocumentRoot /path/to/symfony-cmf/symfony-cmf-standard/web
37-
<Directory /path/to/symfony-cmf/symfony-cmf-standard>
38-
AllowOverride All
39-
</Directory>
40-
</Virtualhost>
27+
* [All Symfony CMF documentation](http://symfony.com/doc/master/cmf/index.html) - complete Symfony CMF reference
28+
* [Symfony CMF Website](http://cmf.symfony.com/) - introduction, live demo, support and community links
4129

42-
And add an entry to your hosts file for "symfony-cmf-standard.lo"
4330

44-
If you are running Symfony2 for the first time, run http://symfony-cmf-standard.lo/config.php to ensure your
45-
system settings have been setup inline with the expected behaviour of the Symfony2 framework.
31+
## Contributing
4632

47-
Then point your browser to http://symfony-cmf-standard.lo/app_dev.php or http://symfony-cmf-standard.lo
33+
Pull requests are welcome. Please see our [CONTRIBUTING](CONTRIBUTING.md) guide.
4834

49-
Functional tests are written with PHPUnit. Note that Bundles and Components are tested independently.
35+
Unit and/or functional tests exist for this bundle. See the
36+
[Testing documentation](http://symfony.com/doc/master/cmf/components/testing.html)
37+
for a guide to running the tests.
5038

51-
app/console doctrine:phpcr:workspace:create standard_test
52-
phpunit -c app
53-
54-
## Configuration
55-
56-
You can use the same steps as for the Symfony2 Standard Edition to check and configure the application:
57-
https://github.com/symfony/symfony-standard#2-checking-your-system-configuration
58-
59-
Note that if you want to improve performance you can enable the caching system:
60-
https://github.com/symfony-cmf/symfony-cmf-standard/blob/master/app/config/parameters.yml#L10
61-
62-
This will enable caching of storage API lookups into the file system. However it can easily be
63-
configured to instead use any of the caching backends supported by Doctrine Common and exposed
64-
by LiipDoctrineCacheBundle:
65-
https://github.com/liip/LiipDoctrineCacheBundle
39+
Thanks to
40+
[everyone who has contributed](https://github.com/symfony-cmf/symfony-cmf-standard/contributors) already.

0 commit comments

Comments
 (0)