cloudnative-pg
Rethink the website's home page
It's not a very welcoming page. There's the link to the documentation, and the link to the blog. The information from CONTRIBUTING.md is not shown anywhere on the site.
I think we could have:
- information on the community: the slack, the community meetings
- links to talks, e.g. Gabriele's talk at Kubecon
- rethink the little snippets we have currently: Autopilot // Data Persistence // Designed for Kubernetes
@jsilvela good afternoon. I'm new to the community and want to contribute. Can I help with this task?
@diegonayalazo certainly you can help! Thank you. At the moment we don't have agreement on what to do here. Do you have suggestions?
Thanks @jsilvela 'for your response. Maybe we can start by getting those agreements in place. I would suggest the community to offer examples of great open source web pages so we can get some inspiration. From my viewpoint having a super easy quickstart is essential to foster adoption. For example a quickstart just to install the operator, and then a few steps to test the fail-over capabilities. Another quickstart that imports an existing pgsql db into the cluster so any dev team can start experiencing the K8s PG experience that our level-5 operator offers.
What do you think?
Thanks! Gracias :)
These sound good @diegonayalazo . Something I've been thinking is that the blog section isn't so useful. It's basically there for announcements. We have some posts that are of a tutorial nature. Perhaps have a new section for tutorials / quickstarts? Also, the CNPG repo does have a quickstart. Do you think that one is adequate?
Thanks, Obrigado :)
@jsilvela Assuming our current audience has Kubernetes knowledge :
For the welcome page, I propose to simplify even more the quickstart in the repo.
For example: taking a bit of part 2 "Installation" where we install the CRD as "Step1". And then deploy the Part 3, were we apply the cluster-example.yaml as "Step 2" .
Finally, offer commands to describe the Cluster or watch the creation process. Also to kill the master and watch the replicas take over.
So, in 15 minutes the potential adoptor / community member can quickly test our technology and evalute if it fits their needs (or even exceeds :) 👍 )
As inspiration, I look at the welcome pages of Kubernetes and Postgresql. Both of them offer upfront a way to learn about the technology. So, along with the quickstart, I would present a link to the documentation.
What do you think?
Got inspired by the 2 click install page from Stackgres. That would be amazing to have so our community can very quickly test CNPG in just a one liner and a few instructions. What's your take on it?
Good suggestion Diego. I like that Stackgres page.
Do you use Slack much or at all? I can see you’re registered but don’t know if you use it or like it.
I ask because we have a dedicated channel, #website which would hopefully be a good meeting point for interested people.
At the moment, active content like that would need some thinking. For the moment it’s a statically generated Hugo site. I do agree though about having a QuickStart.
On 9 Apr 2024, at 00:42, Diego Naya @.***> wrote:
Got inspired by the 2 click install page from Stackgres. That would be amazing to have so our community can very quickly test CNPG in just a one liner and a few instructions. What's your take on it?
— Reply to this email directly, view it on GitHub https://github.com/cloudnative-pg/cloudnative-pg/issues/3749#issuecomment-2043758170, or unsubscribe https://github.com/notifications/unsubscribe-auth/AADHPOE6WB4VBS7WBSK7NG3Y4MMMFAVCNFSM6AAAAABCQY723OVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDANBTG42TQMJXGA. You are receiving this because you were mentioned.