TS needs for configuration and settings.
There are \"TS by example\" and \"TS ref\" docs. Personally I do think it is better to start with TS ref and then take a look in examples. TS ref has examples with explanation as well.
The other way to go is to write an extention. It will clarify a lot (for me at least).
Here is an example how TS it is mainly used:
In your html template you have to put marker or subpart. This marker or subpart then will be replaced with some content. And the content is defined by TS.
1. Say this is a chank of your html with marker:
<hr />
<div>###MARKER_HERE###</div>
<hr />
2. Here is a chank of your TS temploate:
page.20.mark.MARKER_HERE < TEXT
page.20.marks.MARKER_HERE.value = Hey here
The result is that the marker is replaced with \"Hey here\" string. So instead of putting text you can stream output of your script and replace the marker.
If you just started with TYPO I can say from my experience do not experiment on big project. First spend some time and create simple site. It will allow you to get the point. Then thins go smoother with real project.
Have a luck
