Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added information about the Symfony Demo application #5164

Merged
merged 1 commit into from
May 3, 2015
Merged

Added information about the Symfony Demo application #5164

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 17 additions & 8 deletions best_practices/introduction.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,15 +69,23 @@ what you already know.
The Application
---------------

In addition to this guide, you'll find a sample application developed with
all these best practices in mind. **The application is a simple blog engine**,
because that will allow us to focus on the Symfony concepts and features without
getting buried in difficult details.
In addition to this guide, a sample application has been developed with all these
best practices in mind. This project, called the Symfony Demo application, can
be obtained through the Symfony Installer. First, `download and install`_ the
installer and then execute this command to download the demo application:

Instead of developing the application step by step in this guide, you'll find
selected snippets of code through the chapters. Please refer to the last chapter
of this guide to find more details about this application and the instructions
to install it.
.. code-block:: bash

# Linux and Mac OS X
$ symfony demo

# Windows
c:\> php symfony demo

**The demo application is a simple blog engine**, because that will allow us to
focus on the Symfony concepts and features without getting buried in difficult
implementation details. Instead of developing the application step by step in
this guide, you'll find selected snippets of code through the chapters.

Don't Update Your Existing Applications
---------------------------------------
Expand All @@ -95,3 +103,4 @@ practices**. The reasons for not doing it are various:
your tests or adding features that provide real value to the end users.

.. _`Fabien Potencier`: https://connect.sensiolabs.com/profile/fabpot
.. _`download and install`: http://symfony.com/download
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why don't we link to the installation chapter from the book instead?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because in this case we are talking about downloading and installing the installer. The symfony.com/download page is the place where this information is more concisely explained. The installation chapter is more verbose because it explains everything.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, I missed that the download page got some more detailed instructions.