outline methods for rest of lib