Choose the framework to build the doc

[bricefotzo]

Hugo

Pros:

• Speed: Extremely fast build times.
• Performance: Efficient due to being written in Go.
• Customization: Highly customizable and flexible.
• Scalability: Handles large sites well.

Cons:

• Learning Curve: Steep, especially with Go templates.
• Complexity: Setup and customization can be complicated.
• Themes: Variety, but sometimes less professional.

MkDocs

Pros:

• Ease of Use: Simple setup, especially for those familiar with Markdown.
• Professional Look: Excellent default themes, like MkDocs Material.
• Plugins: Extensive ecosystem for added functionality.
• Accessibility: Written in Python, making it approachable for Python developers.

Cons:

• Speed: Slower build times compared to Hugo.
• Scalability: May struggle with very large sites.
• Dependency: Relies on Python, which might be a drawback for non-Python users.

[bricefotzo]

Given those insights I would suggest to use MkDocs as the ease of use, flexibility and extensibility are more important than the speed build in this case

[bricefotzo]

@ajeetraina to keep a track of why we are chosing MkDocs

[ajeetraina]

Thanks for bringing this discussion. Also, I have put it at the right discussion forum https://github.com/kubetoolsca/docs/discussions/3