Skip to content

Commit 3fc1cbb

Browse files
author
Nathan Vonnahme
committed
added several terms to glossary, fixed links
1 parent 6b90b3e commit 3fc1cbb

File tree

2 files changed

+69
-13
lines changed

2 files changed

+69
-13
lines changed

glossary.rst

Lines changed: 64 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,8 @@ Glossary
5353
an application. Instead of creating services directly, the developer
5454
*trains* the service container (via configuration) on how to create
5555
the services. The service container takes care of lazily instantiating
56-
and injecting dependent services.
56+
and injecting dependent services. See :doc:`/book/service_container`
57+
chapter.
5758

5859
HTTP Specification
5960
The *Http Specification* is a document that describes the Hypertext
@@ -71,25 +72,76 @@ Glossary
7172
to have a ``dev`` environment built for debugging and a ``prod`` environment
7273
that's optimized for speed.
7374

74-
vendor
75-
A *vendor* is a supplier of third-party PHP libraries and
76-
bundles. Despite the usual commercial connotations of the word, vendors
75+
Vendor
76+
A *vendor* is a supplier of PHP libraries and bundles including Symfony2
77+
itself. Despite the usual commercial connotations of the word, vendors
7778
in Symfony often (even usually) include free software. Any library you
78-
add to your Symfoony project should go in the `vendor` directory. See
79-
`Architecture: Using Vendors`_.
79+
add to your Symfony2 project should go in the ``vendor`` directory. See
80+
:ref:`The Architecture: Using Vendors <using-vendors>`.
8081

8182
Acme
8283
*Acme* is a sample company name used in Symfony demos and
8384
documentation. For example, it's used as a namespace where you would
84-
normally use your own company's name. See `Acme Corporation at
85-
Wikipedia`_.
85+
normally use your own company's name. See
86+
`Acme Corporation at Wikipedia`_.
8687

8788
Action
88-
An *action* is a
89-
See the :doc:/book/controller chapter.
89+
An *action* is controller code that executes for a given
90+
route. Synonomous with *controller*, but most *controller* PHP classes
91+
include several *actions*. See the
92+
:doc:`Controller Chapter </book/controller>`.
93+
94+
Asset
95+
An *asset* is any non-executable, static component of a web application,
96+
including CSS, js, images and video. Assets may be placed directly in
97+
the project's ``web`` directory, or published from a :term:`Bundle` to the web
98+
directory using the ``assets:install`` console task.
99+
100+
Kernel
101+
The *Kernel* is the core of Symfony2. The Kernel object handles HTTP
102+
requests using all the bundles and libraries registered to it. See
103+
:ref:`The Architecture: The Application Directory <the-app-dir>` and the
104+
:doc:`book/internals/kernel` chapter.
105+
106+
Firewall
107+
In Symfony2, a *Firewall* doesn't have to do with networking. Instead,
108+
it defines the authentication mechanisms, either for the whole
109+
application or for just a part of it. See the
110+
:doc:`book/security/overview` chapters.
111+
112+
YAML
113+
*YAML* is a recursive acronym for "YAML Ain't a Markup Language". It's a
114+
lightweight, humane data serialization language used extensively in
115+
Symfony2's configuration files. See the :doc:`reference/YAML` reference
116+
chapter.
117+
118+
119+
TODO
120+
====
121+
122+
Logical Name
123+
124+
Routing
125+
Resource
126+
127+
Entity (Doctrine)
128+
Entity Repository (Doctrine)
129+
is the new Table / Peer . http://www.doctrine-project.org/docs/orm/2.0/en/tutorials/getting-started-xml-edition.html#entity-repositories
130+
131+
Namespace
132+
133+
Proxy (Doctrine)
134+
A proxy object is an object that is put in place or used instead of the "real" object. See http://www.doctrine-project.org/docs/orm/2.0/en/reference/configuration.html#proxy-objects
135+
136+
Also link to book sections about Environments etc http://symfony.com/doc/2.0/book/page_creation.html
137+
138+
139+
Slots
140+
still exist but they're mostly hidden if you use Twig templates. More obvious in the PHP templates.
141+
142+
90143

91144
.. _`service-oriented architecture`: http://wikipedia.org/wiki/Service-oriented_architecture
92145
.. _`HTTP Wikipedia`: http://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
93146
.. _`HTTP 1.1 RFC`: http://www.w3.org/Protocols/rfc2616/rfc2616.html
94-
.. _`Architecture: Using Vendors`:http://symfony.com/doc/2.0/quick_tour/the_architecture.html#using-vendors
95-
.. _`Acme Corporation at Wikipedia`:http://en.wikipedia.org/wiki/Acme_Corporation
147+
.. _`Acme Corporation at Wikipedia`: http://en.wikipedia.org/wiki/Acme_Corporation

quick_tour/the_architecture.rst

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,8 @@ framework and registers the autoloader (see below).
4141
Like any front controller, ``app.php`` uses a Kernel Class, ``AppKernel``, to
4242
bootstrap the application.
4343

44+
.. _the-app-dir:
45+
4446
The Application Directory
4547
~~~~~~~~~~~~~~~~~~~~~~~~~
4648

@@ -264,6 +266,8 @@ instance.
264266
Do you understand now why Symfony2 is so flexible? Share your bundles between
265267
applications, store them locally or globally, your choice.
266268

269+
.. _using-vendors:
270+
267271
Using Vendors
268272
-------------
269273

@@ -321,4 +325,4 @@ topics now? Look no further - go to the official :doc:`/book/index` and pick
321325
any topic you want.
322326

323327
.. _standards: http://groups.google.com/group/php-standards/web/psr-0-final-proposal
324-
.. _convention: http://pear.php.net/
328+
.. _convention: http://pear.php.net/

0 commit comments

Comments
 (0)