Forward Declarations

Regarding "Forward Declare When Possible", I think you should (almost) never forward declare for the following reasons:

1. It makes backward compatible refactorings more complicated and prone to breakage. This is the reason that the the C++ Standard Library and abseil forbid forward declarations. In C++ you can often refactor a function into a lambda or function object or into a template and keep backward compatibility with uses of the function. However, the signature will have changed.

2. It is dangerous. Forward declarations are an easy way to get hard to diagnose errors like ODR violations. In addition, if something changed in a header you were depending on, forward declarations postpone the error to link-time or to compile time.

3. It is a short term optimization. Hopefully modules in C++ will come soon and make this better. But even without modules, such techniques as pre-compiled headers are safer and work in more scenarios.

Based on these, I think better advice would be to avoid forward declarations.

Comienza localizando la sección de la documentación titulada "Forward Declare When Possible" y leyendo las indicaciones que la rodean y cualquier referencia enlazada. Actualiza la recomendación para reflejar las preocupaciones del issue sobre las forward declarations y, después, confirma que la sección sea internamente coherente y exponga claramente la práctica preferida.

Escrito por el modelo de indexación a partir del texto del issue.