The sprawling Kowloon Walled City, demolished 20 years ago, was reviled in its lifetime. But the structure is now looked upon as a classic of organic design, says James King