Golang-Insiders / site

12 stars 3 forks source link

We should have a blog on the site. #3

Open MatthewJamesBoyle opened 9 months ago

MatthewJamesBoyle commented 9 months ago

On /blog we should have a blog.

Ideally, the blog should be really simple and allow folks to make markdown based PRs that when merged, show up on the site.

saintmalik commented 9 months ago

Hello @MatthewJamesBoyle , I can spin up the blog, in a blog as code manner using docusaurus, would love to pick this issue up

MatthewJamesBoyle commented 9 months ago

Amazing! Maybe let's leave this open for a couple of days and see if folks have any strong preference on platform. I have used Hugo before and had a good experience. I have never used docasaurus. I'd have a bias for Hugo, since it's written in Go unless Docasaurus gives us more features.

saintmalik commented 9 months ago

Great noted, worked with Hugo before too both works, yes docusaurus provides documentation options too

tylermmorton commented 9 months ago

Hey, I'm building a hypermedia based web server framework in Go called torque, and I have a doc site implementation that I use to power https://lbft.dev

It's really basic but I think it could be a good starting place for a blog too. It uses htmx and Go templates. https://github.com/tylermmorton/torque/tree/master/.www/docsite

Hugo is great for static sites and if that is all that is needed then all good! Just wanted to pitch this as an idea.

MatthewJamesBoyle commented 9 months ago

I see the site as having two pieces. One is the blog - I think this makes sense to be static and would make it real easy for folks to contribute via markdown.

The other is more dynamic: homepage, about, talk submission, old videos of meet-ups, maybe eventually a job board.

There is another task for "build a homepage" where there is some more discussion :)

tylermmorton commented 9 months ago

On the torque docsite all of the content is static markdown files. When the application starts, the markdown is parsed and converted to HTML, then rendered per request.

As far as dynamic content like talk submissions and a job board, I think a route module with action handlers could work for this. We'd need a way to store the data, though. Maybe Notion or Google Sheets if a managed database is out of our price range.

namkatcedrickjumtock commented 9 months ago

@MatthewJamesBoyle just a thought, maybe Jekyll could be used to generate the static peace of the blog, think it's pretty popular and easier for devs to contribute.

MatthewJamesBoyle commented 9 months ago

Happy to give Torque a go since it's built by someone in the community and hopefully it helps you drive adoption by having more folks using it :). Do you want to take this one still @saintmalik ?

MatthewJamesBoyle commented 8 months ago

Hey @saintmalik , just following up to see if I can help at all

MatthewJamesBoyle commented 8 months ago

Hey @tylermmorton , do you want to pick this up instead?

saintmalik commented 8 months ago

Hey @saintmalik , just following up to see if I can help at all

I would pick this up

tylermmorton commented 8 months ago

@saintmalik I'm happy to collab if you need help! I'm also open to whatever solution you would prefer as well.

The holidays are a busy time for me so I may be slow to respond. I do plan to attend the December meetup next Thursday though so maybe we can have a quick chat after if you're there 😀

saintmalik commented 8 months ago

@saintmalik I'm happy to collab if you need help! I'm also open to whatever solution you would prefer as well.

The holidays are a busy time for me so I may be slow to respond. I do plan to attend the December meetup next Thursday though so maybe we can have a quick chat after if you're there 😀

No issues at all, I do understand, I would figure it out and if I am stucked, I can always tag you on here.

Happy to chat also in the next meetup