Skip to content

Commit a6f299e

Browse files
weaverryanweaverryan
committed
minor #8537 Docs re-org and removal of small sections (weaverryan)
This PR was squashed before being merged into the 2.7 branch (closes #8537). Discussion ---------- Docs re-org and removal of small sections Hi guys! I'd like to have less "Guides" on the left. Some of them only have 1 article or (imo) are not something that's helpful for the user. In this PR, i: 1) Move Assetic out of the top-level and under `frontend`. 2) Removed/moved the Expressions guide 3) Removed/moved the "Request" guides On Symfony.com, we would need to remove the "Assetic", "Expressions" and "Request" guides. All of this content still exists, just somewhere else. The bigger goal is - through a number of PR's - to reduce the number of "guides" links and make sure we have the best links that people will be looking for. Thanks! Commits ------- 678a921 Docs re-org and removal of small sections
2 parents 0c6df00 + 678a921 commit a6f299e

25 files changed

+113
-178
lines changed

‎_build/redirection_map

Lines changed: 21 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -76,13 +76,20 @@
7676
/book/configuration /configuration
7777
/book/propel /propel/propel
7878
/book/performance /performance
79-
/cookbook/assetic/apply_to_option /assetic/apply_to_option
80-
/cookbook/assetic/asset_management /assetic/asset_management
81-
/cookbook/assetic/index /assetic
82-
/cookbook/assetic/jpeg_optimize /assetic/jpeg_optimize
83-
/cookbook/assetic/php /assetic/php
84-
/cookbook/assetic/uglifyjs /assetic/uglifyjs
85-
/cookbook/assetic/yuicompressor /assetic/yuicompressor
79+
/cookbook/assetic/apply_to_option /frontend/assetic/apply_to_option
80+
/cookbook/assetic/asset_management /frontend/assetic/asset_management
81+
/cookbook/assetic/index /frontend/assetic
82+
/cookbook/assetic/jpeg_optimize /frontend/assetic/jpeg_optimize
83+
/cookbook/assetic/php /frontend/assetic/php
84+
/cookbook/assetic/uglifyjs /frontend/assetic/uglifyjs
85+
/cookbook/assetic/yuicompressor /frontend/assetic/yuicompressor
86+
/assetic /frontend/assetic
87+
/assetic/apply_to_option /frontend/assetic/apply_to_option
88+
/assetic/asset_management /frontend/assetic/asset_management
89+
/assetic/jpeg_optimize /frontend/assetic/jpeg_optimize
90+
/assetic/php /frontend/assetic/php
91+
/assetic/uglifyjs /frontend/assetic/uglifyjs
92+
/assetic/yuicompressor /frontend/assetic/yuicompressor
8693
/cookbook/bundles/best_practices /bundles/best_practices
8794
/cookbook/bundles/configuration /bundles/configuration
8895
/cookbook/bundles/extension /bundles/extension
@@ -150,7 +157,8 @@
150157
/cookbook/event_dispatcher/event_listener /event_dispatcher
151158
/cookbook/event_dispatcher/index /event_dispatcher
152159
/cookbook/event_dispatcher/method_behavior /event_dispatcher/method_behavior
153-
/cookbook/expressions /expressions/expressions
160+
/cookbook/expressions /security/expressions
161+
/expressions /security/expressions
154162
/cookbook/form/create_custom_field_type /form/create_custom_field_type
155163
/cookbook/form/create_form_type_extension /form/create_form_type_extension
156164
/cookbook/form/data_transformers /form/data_transformers
@@ -181,10 +189,10 @@
181189
/cookbook/profiler/matchers /profiler/matchers
182190
/cookbook/profiler/profiling_data /profiler/profiling_data
183191
/cookbook/profiler/storage /profiler/storage
184-
/cookbook/psr7 /request/psr7
192+
/cookbook/psr7 /components/psr7
185193
/cookbook/request/index /request
186-
/cookbook/request/load_balancer_reverse_proxy /request/load_balancer_reverse_proxy
187-
/cookbook/request/mime_type /request/mime_type
194+
/cookbook/request/load_balancer_reverse_proxy /deployment/proxies
195+
/cookbook/request/mime_type /reference/configuration/framework#formats
188196
/cookbook/routing/conditions /routing/conditions
189197
/cookbook/routing/custom_route_loader /routing/custom_route_loader
190198
/cookbook/routing/debug /routing/debug
@@ -303,6 +311,7 @@
303311
/components/form/type_guesser /form/type_guesser
304312
/components/http_foundation/index /components/http_foundation
305313
/components/http_foundation/introduction /components/http_foundation
314+
/components/http_foundation/trusting_proxies /deployment/proxies
306315
/components/http_kernel/introduction /components/http_kernel
307316
/components/http_kernel/index /components/http_kernel
308317
/components/property_access/introduction /components/property_access
@@ -327,3 +336,4 @@
327336
/form /forms
328337
/testing/simulating_authentication /testing/http_authentication
329338
/validation/group_service_resolver /form/validation_group_service_resolver
339+
/request/load_balancer_reverse_proxy /deployment/proxies

‎best_practices/web-assets.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ tools like GruntJS.
4949
Use Assetic to compile, combine and minimize web assets, unless you're
5050
comfortable with frontend tools like GruntJS.
5151

52-
:doc:`Assetic </assetic/asset_management>` is an asset manager capable
52+
:doc:`Assetic </frontend/assetic/asset_management>` is an asset manager capable
5353
of compiling assets developed with a lot of different frontend technologies
5454
like LESS, Sass and CoffeeScript. Combining all your assets with Assetic is a
5555
matter of wrapping all the assets with a single Twig tag:
@@ -87,8 +87,8 @@ Learn More about Assetic
8787
------------------------
8888

8989
Assetic can also minimize CSS and JavaScript assets
90-
:doc:`using UglifyCSS/UglifyJS </assetic/uglifyjs>` to speed up your
91-
websites. You can even :doc:`compress images </assetic/jpeg_optimize>`
90+
:doc:`using UglifyCSS/UglifyJS </frontend/assetic/uglifyjs>` to speed up your
91+
websites. You can even :doc:`compress images </frontend/assetic/jpeg_optimize>`
9292
with Assetic to reduce their size before serving them to the user. Check out
9393
the `official Assetic documentation`_ to learn more about all the available
9494
features.

‎components/expression_language.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,6 @@ Learn More
119119
:maxdepth: 1
120120
:glob:
121121

122-
/expressions
123122
/components/expression_language/*
124123
/service_container/expression_language
125124
/reference/constraints/Expression

‎components/http_foundation.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -611,7 +611,6 @@ Learn More
611611
/components/http_foundation/*
612612
/controller
613613
/controller/*
614-
/request/*
615614
/session/*
616615
/http_cache/*
617616

‎components/http_foundation/trusting_proxies.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Trusting Proxies
77
.. tip::
88

99
If you're using the Symfony Framework, start by reading
10-
:doc:`/request/load_balancer_reverse_proxy`.
10+
:doc:`/deployment/proxies`.
1111

1212
If you find yourself behind some sort of proxy - like a load balancer - then
1313
certain header information may be sent to you using special ``X-Forwarded-*``

‎request/psr7.rst renamed to ‎components/psr7.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Installation
1313

1414
You can install the component in 2 different ways:
1515

16-
* :doc:`Install it via Composer </components/using_components>` (`symfony/psr-http-message-bridge on Packagist <https://packagist.org/packages/symfony/psr-http-message-bridge>`_);
16+
* :doc:`Install it via Composer </components/using_components>` (`symfony/psr-http-message-bridge on Packagist`_);
1717
* Use the official Git repository (https://github.com/symfony/psr-http-message-bridge).
1818

1919
The bridge also needs a PSR-7 implementation to allow converting HttpFoundation
@@ -87,3 +87,4 @@ to a :class:`Symfony\\Component\\HttpFoundation\\Response` instance::
8787

8888
.. _`PSR-7`: http://www.php-fig.org/psr/psr-7/
8989
.. _`Zend Diactoros`: https://github.com/zendframework/zend-diactoros
90+
.. _`symfony/psr-http-message-bridge on Packagist`: https://packagist.org/packages/symfony/psr-http-message-bridge

‎request/load_balancer_reverse_proxy.rst renamed to ‎deployment/proxies.rst

File renamed without changes.

‎frontend.rst

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,11 @@ Front-end
22
=========
33

44
See the latest version of the docs for frontend tools. Or, see
5-
:doc:`/assetic`.
5+
:doc:`/frontend/assetic`.
66

7+
.. toctree::
8+
:maxdepth: 1
9+
:glob:
10+
:hidden:
11+
12+
frontend/*

‎assetic.rst renamed to ‎frontend/assetic.rst

File renamed without changes.

‎assetic/apply_to_option.rst renamed to ‎frontend/assetic/apply_to_option.rst

File renamed without changes.

0 commit comments

Comments
 (0)