[TYPO3-english] DIR include of TypoScript

[d.ros]

I don´t understand the whole discussion. At least the integrator has to 
map from the correspoding field (Template:setup | page:tsConfig | etc. 
). So this is the indicator.

IMHO: The only thing that has to be done better, would be a sufficent 
helptext beside these fields that points out the usage of the different 
types of TYPOSCRIPT code. Thats all. In Snippets it is mostly pointed 
out where the code belongs into.

In the Docs #1 it has to be pointed out more precise which contexts are 
available and which is ment for what. This is at the moment not optimal 
done.

#1
http://docs.typo3.org/typo3cms/TyposcriptSyntaxReference/singlehtml/#includes

Secondly it would be quite useful to give advice in the Docs within 
#includes section of recommended naming rules like:

"It it useful to name your Files in CamelCase and mention the scope in 
the filename.

Examples:

#Template Setup field
<INCLUDE_TYPOSCRIPT: source="FILE: 
fileadmin/html/MainMenu_TemplateSetup.txt">

#Template Setup Constants field
<INCLUDE_TYPOSCRIPT: source="FILE: 
fileadmin/html/MainTemplate_TemplateSetupConstants.txt">

#User TS Config
<INCLUDE_TYPOSCRIPT: source="FILE: 
fileadmin/html/AllUsersDirectives_UserTSconfig.txt">

#Page TS Config
<INCLUDE_TYPOSCRIPT: source="FILE: 
fileadmin/html/AllPagesDirectives_PageTSconfig.txt">

This is strongly recommended but it is not mandatory.

"


That way nothing has to be changed exept the way things are communicated.


Conclusion: IMHO the whole discussion is a discussion for discussion. 
This is a quite practical approach for a trivial problem of explaining 
things right.



Cheers

David