I'm not entirely sure how the new documentation looks, but it seems like these functions may be *the* functions for creating file readers/writers, so putting examples directly in the documentation may not be a bad idea.