Document Si track extension - first batch

This MR contains the initial work towards cleaning up and documenting the combinatorial silicon track extension - including the SiTrackMaker_xk, SiCombinatorialTrackFinder_xk, SiTrajectory_xk, SiTrajectoryElement_xk.

The changes attempt to make the code more readable for newcomers and document the logic in a more accessible way to users studying the code, while preserving the elegance of the original implementation. No performance changes are expected.

As the classes are tightly coupled, they can only be documented together. As a result, there is a large number of changed lines throughout the affected classes, even though the vast majority of changes are just formatting, renaming, and comments.

Given that I have reached 1400 lines of changes, with a related growth in the risk of merge conflicts (already had one), I am containing the progress so far within this MR, and will follow up in another.

Adding @sroe, @npetters, @sswatman and @zschilla

Also adding @jsandesa - do any of my changes clash with developments you are working on?

InnerDetector/InDetRecEvent/SiSPSeededTrackFinderData/src/SiTrajectoryElement_xk.cxx

@@ -830,8 +830,7 @@ void  InDet::SiTrajectoryElement_xk::noiseProduction
   /// 1 - Az² --> squared transverse direction component 
   double d = (1.-m_localDir[2])*(1.+m_localDir[2]);   
   /// if too small, set to a reasonable minimum 
-  if(d < 1.e-5) 
-  d = 1.e-5;
+  if(d < 1.e-5) d = 1.e-5;
   /// azimuthal component: scale with 1/d 
   double covarianceAzim = covariancePola/d;