cleaner code examples and some misc