updated documentation and tag creation logic