Sync docs from 1.1.x to gh-pages

1.1.x/index.html

@@ -1573,6 +1573,20 @@ Always clean after you create a span! Don’t forget to close a span if you
 </tr>
 </table>
 </div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Important</div>
+</td>
+<td class="content">
+If your span contains a name greater than 50 chars, then that name will
+be truncated to 50 chars. Your names have to be explicit and concrete. Big names lead to
+latency issues and sometimes even thrown exceptions.
+</td>
+</tr>
+</table>
+</div>
 </div>
 <div class="sect2">
 <h3 id="continuing-spans">Continuing spans</h3>