some documentation for custom writers