Added documentation to warn clients about thread-local behavior of  methods.