-
-
Notifications
You must be signed in to change notification settings - Fork 65.1k
Update "Symfony: The Fast Track" book #12769
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
base: main
Are you sure you want to change the base?
Conversation
| * [En route pour Symfony 5.4](https://symfony.com/doc/5.4/the-fast-track/fr/index.html) - Fabien Potencier | ||
| * [En route pour Symfony 6.2](https://symfony.com/doc/current/the-fast-track/fr/index.html) - Fabien Potencier | ||
| * [Symfony 5: la voie rapide](https://symfony.com/doc/5.4/the-fast-track/fr/index.html) - Fabien Potencier (HTML) | ||
| * [Symfony 6: la voie rapide](https://symfony.com/doc/6.4/the-fast-track/fr/index.html) - Fabien Potencier (HTML) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
https://symfony.com/doc/current/the-fast-track/fr/index.html gives acces to both; just use one link
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- don't use 2 links if 1 link offers both versions.
- don't replace a newer archived version with an older one
| #### Symfony | ||
|
|
||
| * [سیمفونی ۵: سریعترین مسیر‏](https://web.archive.org/web/20210122133755/https://symfony.com/doc/current/the-fast-track/fa/index.html) - *( :card_file_box: archived)* | ||
| * [Symfony 5: شروع سریع](https://web.archive.org/web/20200930102029/https://symfony.com/doc/5.0/the-fast-track/fa/index.html) - Fabien Potencier (HTML) *( :card_file_box: archived)* |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
why replace a 2021 version with a 2020 version?
| * [Symfony 1.4, la guía definitiva](http://librosweb.es/libro/symfony_1_4) - Fabien Potencier, François Zaninotto, `trl.:` Javier Eguíluz Pérez (HTML) [(PDF)](https://openlibra.com/es/book/download/symfony-la-guia-definitiva) | ||
| * [Symfony 2.4, el libro oficial](http://librosweb.es/libro/symfony_2_4/) - Fabien Potencier, Ryan Weaver, `trl.:` Javier Eguíluz Pérez (HTML) [(PDF)](https://openlibra.com/es/book/download/manual-de-symfony2-ver-2-0-12) | ||
| * [Symfony 5: La Vía Rápida](https://web.archive.org/web/20210805141343/https://symfony.com/doc/current/the-fast-track/es/index.html) - Fabien Potencier (HTML) | ||
| * [Symfony 5: La Vía Rápida](https://web.archive.org/web/20210712175052/https://symfony.com/doc/5.0/the-fast-track/es/index.html) - Fabien Potencier (HTML) *( :card_file_box: archived)* |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
dont replace on newer version with an older version
|
|
||
| * [Symfony: Auf der Überholspur](https://symfony.com/doc/current/the-fast-track/de/index.html) (Online) | ||
| * [Symfony 5: Auf der Überholspur](https://symfony.com/doc/5.4/the-fast-track/de/index.html) - Fabien Potencier (HTML) | ||
| * [Symfony 6: Auf der Überholspur](https://symfony.com/doc/6.4/the-fast-track/de/index.html) - Fabien Potencier (HTML) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
where you have one link that gives you both version, use the one link
|
|
||
| #### Symfony | ||
|
|
||
| * [Symfony 5: بداية سريعة](https://web.archive.org/web/20200925101710/https://symfony.com/doc/5.0/the-fast-track/ar/index.html) - Fabien Potencier (HTML) *( :card_file_box: archived)* |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
add the
| #### Symfony | ||
|
|
||
| * [Symfony 5: guida rapida](https://symfony.com/doc/5.4/the-fast-track/it/index.html) - Fabien Potencier (HTML) | ||
| * [Symfony 6: guida rapida](https://symfony.com/doc/6.4/the-fast-track/it/index.html) - Fabien Potencier (HTML) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
one "current link is enough
| #### Symfony | ||
|
|
||
| * [Symfony 5・高速コース](https://symfony.com/doc/5.4/the-fast-track/ja/index.html) - Fabien Potencier (HTML) | ||
| * [Symfony 6・高速コース](https://symfony.com/doc/6.4/the-fast-track/ja/index.html) - Fabien Potencier (HTML) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
one "current" link is better
| * [Symfony 5.4: The Fast Track](https://symfony.com/doc/5.4/the-fast-track/en/index.html) | ||
| * [Symfony 6.2: The Fast Track](https://symfony.com/doc/6.2/the-fast-track/en/index.html) | ||
| * [Symfony 5: The Fast Track](https://symfony.com/doc/5.4/the-fast-track/en/index.html) - Fabien Potencier (HTML) | ||
| * [Symfony 6: The Fast Track](https://symfony.com/doc/6.4/the-fast-track/en/index.html) - Fabien Potencier (HTML) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
one "current" link is better
| * [Symfony 5.4: Быстрый старт](https://symfony.com/doc/5.4/the-fast-track/ru/index.html) | ||
| * [Symfony 6.2: Быстрый старт](https://symfony.com/doc/6.2/the-fast-track/ru/index.html) | ||
| * [Symfony 5. Быстрый старт](https://symfony.com/doc/5.4/the-fast-track/ru/index.html) - Fabien Potencier (HTML) | ||
| * [Symfony 6. Быстрый старт](https://symfony.com/doc/6.4/the-fast-track/ru/index.html) - Fabien Potencier (HTML) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
one "current" link is better
|
@eshellman, Please note that these are two different books, and the content varies depending on the Symfony version. The official website provides links to both editions: Regarding using a link to the current version, I read the contribution guidelines before submitting a PR. However, in this case, this could lead to unexpected situations, since, for example, after the book is released for the next Symfony version, the link would point to the new edition instead of the expected one. Unfortunately, there is no permanent (current) link to a specific edition. We could have left only the most current revision, but major versions do not guarantee compatibility, and the content may not be up-to-date. That's why two editions are provided instead of one. The archive links have been updated according to these notes, and this does not affect the currentness of the book's content, even if the snapshot is older than the previous one. |
|
The big advantage of "current" links for us is that they should work even if you don't come back to update them. It should not be our job to track versions. please follow the recommendations given. |
|
@eshellman, I understand why you prefer "current" links, but in this case, it won't work as you expect for the reason I described above. Using "current" links will eventually result in the user seeing content that isn't expected. Furthermore, versions 5.4 and 6.4 are final releases and won't be changed in the future. |
What does this PR do?
Add resource(s)
IMPORTANT
For resources
Description
Update "Symfony 5: The Fast Track" book.
Why is this valuable (or not)?
This book shows developers the power of the framework and how it can improve their productivity.
How do we know it's really free?
This book is written by the Symfony author (Fabien Potencier) and is hosted on the Symfony official website.
For book lists, is it a book? For course lists, is it a course? etc.
It is a book.
Checklist:
Follow-up