feat: Update Hugo Template to Docsy

[schristoff]

I believe Docsy would be the easiest lift and shift that suites our needs as a product, but I am open to other solutions. I have not scoped out the work to move our website theme.

[kumarankit999]

Can I work on this issue, I would love to help this out

[schristoff]

Sure @kumarankit999 - we would love the help!
I don't think it's going to be an easy 'lift and shift', but when you make a PR it should publish any changes to netlify so that we can all view them too. If you get stuck or need any feedback quickly, I highly suggest the #porter channel in the CNCF slack as well, as all the maintainers are sitting in there :)

[zelfroster]

Sure @kumarankit999 - we would love the help! I don't think it's going to be an easy 'lift and shift', but when you make a PR it should publish any changes to netlify so that we can all view them too. If you get stuck or need any feedback quickly, I highly suggest the #porter channel in the CNCF slack as well, as all the maintainers are sitting in there :)

I would also love to help. I have built my site with Hugo, so I have some experience.

[zelfroster]

I believe Docsy would be the easiest lift and shift that suites our needs as a product, but I am open to other solutions. I have not scoped out the work to move our website theme.

Hello @schristoff, I have been looking into some Hugo themes for documentation. And this one looks promising, https://getdoks.org/ . Please check this out.
And, Kindly tell me if we should proceed with that. One more thing, The documentation part is not dependent on porter installation and running, right?

[schristoff]

Hi @zelfroster - posting in here (even though addressed in Slack)
Doks is totally great! I think it's a cool theme.
The documentation part is not dependent on a porter installation - that is correct :)

[zelfroster]

Hey @schristoff, Here is an update on this work, as much as I wanted to use Doks, after seeing the way it is needed to set up, I don't want to use it anymore.

The reason being It doesn't use the Hugo modules or git submodules, rather It uses Node.js for managing and updating the theme, which adds a lot of files and dependencies in the project to be maintained on our end. While that can be beneficial and provide more control for some people, It seems unnecessary to me.

I have been looking for another theme and found Hextra, It is very simple and clean and does the job for us. I wanted to present a working version so that I can get the community members feedback to go on with this. Here's a working version https://64f899057ff7e32422ae7629--verdant-cupcake-b7edc5.netlify.app/

I have almost ported the theme to Hextra, but will also need inputs and clarifications for doing it the correct way, as I did it in one go 😅. Please give your valuable feedback.

[schristoff]

❗ Omg, I love it. It looks very modern, sleek, what a great choice!
Thank you so much for creating a preview as well.
Once the port over to Hextra is done I think the next step will be to spruce up that homepage.
I'll nitpick on the format of the homepage and such when we get a PR up and ready. I cannot overstate how jazzed I am to see this. :)

[zelfroster]

❗ Omg, I love it. It looks very modern, sleek, what a great choice! Thank you so much for creating a preview as well. Once the port over to Hextra is done I think the next step will be to spruce up that homepage. I'll nitpick on the format of the homepage and such when we get a PR up and ready. I cannot overstate how jazzed I am to see this. :)

Thank you so much <3 !!
I will start the work with a draft PR soon. Please assign this issue to me.