Ryan Weaver, Symfony core team member and SymfonyCasts founder, needs our help

The new Getting Started tutorial

May 26, 2009 · Published by Avatar of Fabien Potencier Fabien Potencier

Today, I have published a "Getting Started" tutorial for symfony 1.2.

Why a new Guide?

As of now, the information needed to install symfony were available but they were disseminated in many different places (the installation page, the Jobeet tutorial, the old symfony book). But the main problem was that the best way to install symfony was not the easiest piece of information to find.

This new tutorial aims to become the definitive place to find all information related to the symfony installation process. It describes in great details everything you need to know to install symfony correctly. The goal is to also provide a single resource for people wanting to try out the framework and avoid discouraging them with a bad installation experience.

I have also rewritten the 1.2 installation page with a link to this new tutorial and cleaned up the information it gives to avoid redundant information. The same goes for the main symfony homepage.

What's Next?

As this guide is mainly for newcomers, I really think everybody following this blog has something to say about it. I am for instance thinking about writing a troubleshooting section at the end of the tutorial to describe the common problems that can arise and their solutions. Feel free to send me an email about your idea, or discuss them in the comments.

Published in #Community #Documentation

Help the Symfony project!

As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.

Comments

Avatar of Wodkaist
Wodkaist said on May 26, 2009
This tutorial doesn't use the symfony commands like "./symfony fix-perms".

It was also previously said that a command "./symfony check-configuration" was created.

Any reason ?
Avatar of Markus Staab
Markus Staab said on May 26, 2009
would be nice to have a overview page at the beginning of the getting started guide which includes all the pages.

so it's easier to jump into the docs...
Avatar of saganxis
saganxis said on May 26, 2009
agree with Markus Staab.
Avatar of Fabien
Fabien said on May 26, 2009
@Markus Staab, @saganxis: done
Avatar of kindrosker
kindrosker said on May 27, 2009
yes, "easier to jump into the docs." it's small problem in all symofny docs

I'm thinking that javascript menu or something else in header will be great
Avatar of kindrosker
kindrosker said on May 27, 2009
@Fabien: maybe there is sense to do the same in The Definitive Guide where we can see all Chapter in right column when we read chapter ex: http://www.symfony-project.org/book/1_2/06-Inside-the-Controller-Layer,

what do you think?
Avatar of kindrosker
kindrosker said on May 27, 2009
@Fabien:
also what do you think about this
http://forum.symfony-project.org/index.php?t=msg&goto=77514&#msg_77514

Comments are closed.

To ensure that comments stay relevant, they are closed for old posts.