General update and refresh of documentation

[mperrin]

Could use some modernization.

• Cleanup and organize better the example codes
• Switch to STScI-template documentation theme?
• Similar for POPPY also.