Skip to content

Summarize Twig integration documentation #4301

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.

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

Closed
javiereguiluz opened this issue Oct 7, 2014 · 5 comments
Closed

Summarize Twig integration documentation #4301

javiereguiluz opened this issue Oct 7, 2014 · 5 comments

Comments

@javiereguiluz
Copy link
Member

This issue has been created to ask documentation managers and community in general if you think it could be a good idea to summarize somewhere all the Twig features exclusive to Symfony applications.

This information cannot be added to the official Twig documentation so right know most (all?) of the things are dispersed in the Symfony docs. It's not common, but sometimes I've needed the full list of Twig features exclusive for Symfony, so I'd like to add it somewhere.

The idea is not to duplicate the explanations of the doc, but to summarize all these features in a single location. Things we could talk about:

  • asset() function
  • path() and url() function
  • app global object
  • trans and transchoice filters
  • twig:lint and twig:debug commands
  • what else?
@xabbuh
Copy link
Member

xabbuh commented Oct 8, 2014

We already have the reference for form functions and variables which are also specific to Symfony. So, I don't see why we should not build a general section with all the specific things. 👍

@wouterj
Copy link
Member

wouterj commented Oct 8, 2014

We already have such document: http://symfony.com/doc/current/reference/twig_reference.html (except from the commands)

@javiereguiluz
Copy link
Member Author

@wouterj that's exactly what I wanted and couldn't find! Thanks Wouter! I wonder why I failed miserably at finding this article :(

A comment about the document: the table layout looks awful because the code is packed and syntax highlighting is missing. Could we update it or you prefer the current compact layout?

@wouterj
Copy link
Member

wouterj commented Oct 10, 2014

@javiereguiluz while I introduced the table, I do fully agree that it doesn't look great. I've updated the complete twig reference to be a lot nicer and have a lot more usefull information: #4313

weaverryan added a commit that referenced this issue Nov 7, 2014
This PR was merged into the 2.3 branch.

Discussion
----------

Improved and fixed twig reference

| Q   | A
| --- | ---
| Doc fix? | yes
| New docs? | yes
| Applies to | 2.3+
| Ficket tickets | #4301

Removed the ugly looking tables and added some more details.

Commits
-------

ad6b084 Improved and fixed twig reference
@wouterj
Copy link
Member

wouterj commented Nov 7, 2014

Fixed now

@wouterj wouterj closed this as completed Nov 7, 2014
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants