Universal Blue•2y ago

I’ve built a lot around Hugo ( I own an index of U2F keys at https://U2F.garden ) and would be willi

I’ve built a lot around Hugo ( I own an index of U2F keys at https://U2F.garden ) and would be willing to help.

Keys | The U2F Garden

The U2F Garden is a catalog of U2F tokens

Ttryhardsoccermomswag and yea its discourse. we got a free discourse so we're using that shit. we're...

Pez•6/28/24, 12:44 AM

neocities supporter plan is straight up awesome for hosting static sites

tryhardsoccermomswag•6/28/24, 12:45 AM

gonna need approval from @j0rge for this but we'd appreciate anything yea, and thanks for suggesting neocities Pez i forgot that existed lol

Pez•6/28/24, 12:45 AM

if you have a slim layout and follow certain rules you can have docs that load REALLY easily

Pez•6/28/24, 12:45 AM

it's how we host https://docs.nzp.gay

Nazi Zombies: Portable Documentation

Official Mapping and Core documentation for the Quake project Nazi Zombies: Portable

Iindrora I’ve built a lot around Hugo ( I own an index of U2F keys at https://U2F.garden ...

j0rge•6/28/24, 12:46 AM

YESSSSSSS

j0rge•6/28/24, 12:46 AM

this is what we need:

Ttryhardsoccermomswag gonna need approval from @j0rge for this but we'd appreciate anything yea, and t...

indroraOP•6/28/24, 12:46 AM

Neocities is nice but you have GH pages right there

Pez•6/28/24, 12:46 AM

gh pages enforces a heavy webframe etc.

Pez•6/28/24, 12:46 AM

it's honestly kinda gross..

Jj0rge YESSSSSSS

indroraOP•6/28/24, 12:46 AM

Check the GitHub for it out.

It’s all frontmatter controlled.

j0rge•6/28/24, 12:47 AM

basically we want to slurp the documentationdocumentation tags from discourse, take those markdown files, pipe them through a github action, and then spit out a hugo/docsy static site

Pez•6/28/24, 12:47 AM

oh that's a sinch

j0rge•6/28/24, 12:47 AM

I am familiar with hugo, I know some of the authors, I just suck at it lol

Iindrora Neocities is nice but you have GH pages right there

tryhardsoccermomswag•6/28/24, 12:47 AM

we had a github mkdocs page before this so discourse was actually a better solution

Pez•6/28/24, 12:47 AM

but for $5 you get way better hosting than ghpages as far as policies go

Pez•6/28/24, 12:47 AM

and you are supporting a good crew

j0rge•6/28/24, 12:48 AM

plus here's the thing, that'd be an awesome action for tons of oss projects. Discourse gives away their forum to OSS people, github hosts gh-pages, make it trivial for OSS projects to make awesome docs by using discourse as a CMS for hugo.

Jj0rge basically we want to slurp the `documentation` tags from discourse, take those m...

indroraOP•6/28/24, 12:48 AM

As someone who’s written docs professionally (I was at AWS for four years) I can say that just maintaining some markdown files as a GH repo is far preferable to maintain than scraping a live forum.

Forums are for ephemeral and non-essential content

j0rge•6/28/24, 12:48 AM

we ran our own static site generator for a while

Pez•6/28/24, 12:48 AM

the forum posts are just pinned topic headers anyway

Pez•6/28/24, 12:49 AM

the ones they're directly referencing i assume

j0rge•6/28/24, 12:49 AM

the problem is no one contributes to raw markdown files in a github repo

j0rge•6/28/24, 12:49 AM

whereas on the forum we just organize by tag and use them as wiki page, it's just the presentation sucks

Jj0rge the problem is no one contributes to raw markdown files in a github repo

indroraOP•6/28/24, 12:49 AM

? If you have a link to update the page that takes you straight to the editor, people do.

tryhardsoccermomswag•6/28/24, 12:49 AM

i mean tbh jorge nobody outside of the ublue/bazzite contributors really contrbutes to the docs anyways

Pez•6/28/24, 12:49 AM

Ttryhardsoccermomswag i mean tbh jorge nobody outside of the ublue/bazzite contributors really contrbu...

j0rge•6/28/24, 12:50 AM

right, but that's independent of the tech we use.

Pez•6/28/24, 12:50 AM

you have to babysit the people that are gonna want to do that stuff anyway.

Tsubajashi (ツバジャシ)•6/28/24, 12:50 AM

given i will daily drive bazzite when my new PC comes in, i guess i would have no problem contributing to docs

Jj0rge right, but that's independent of the tech we use.

tryhardsoccermomswag•6/28/24, 12:50 AM

true

j0rge•6/28/24, 12:50 AM

like, no one is reading nor writing the docs no matter what we pick except nickname and me lol

Pez•6/28/24, 12:50 AM

next time somebody does offer

tryhardsoccermomswag•6/28/24, 12:50 AM

i like reading my own docs

Pez•6/28/24, 12:50 AM

like this kind person above

Pez•6/28/24, 12:50 AM

gotta take them under your wing a bit

Jj0rge like, no one is reading nor writing the docs no matter what we pick except nickn...

indroraOP•6/28/24, 12:50 AM

You’d be surprised

Pez•6/28/24, 12:50 AM

make sure they're happy with putting that effort in

Tsubajashi (ツバジャシ)•6/28/24, 12:51 AM

still trying to find the justfile that involves "configure-nvidia" where i wanted to add additional kargs as i wrote in #bazzite-dev haha

Pez•6/28/24, 12:51 AM

most people don't stick around for nothing

indroraOP•6/28/24, 12:51 AM

A lot of people updated the stuff I was responsible for when I was at aws, and that was just “click button, make change, submit Pr

Wheeler•6/28/24, 12:51 AM

Rebasing to :testing. Got this:

Importing packages... done
Relabeling... done
Checking out packages... done
error: Checkout python3-typing-extensions-4.9.0-3.fc40.noarch: Hardlinking 91/b18c79d2bde4a094e47e5520982a4373ec0819e1ad2361869c619c3b6d753c.file to typing_extensions.py: File exists

Importing packages... done
Relabeling... done
Checking out packages... done
error: Checkout python3-typing-extensions-4.9.0-3.fc40.noarch: Hardlinking 91/b18c79d2bde4a094e47e5520982a4373ec0819e1ad2361869c619c3b6d753c.file to typing_extensions.py: File exists

j0rge•6/28/24, 12:51 AM

yeah but this is nothing like our day jobs, haha

Pez•6/28/24, 12:51 AM

docs really is a hard one and if people want to contribute they're probably gonna write the stuff up-front with little regard for how it gets hosted in the end

Wheeler•6/28/24, 12:52 AM

Can't seem to rebase with this python error. Something weird I need to fix?

Pez•6/28/24, 12:52 AM

you just have to be a facilitator where you can :v

j0rge•6/28/24, 12:52 AM

I mean, I freaking wish it was just like contributing to the k8s docs, but it's a totally different crowd

WWheeler Rebasing to :testing. Got this: ```Importing packages... done Relabeling... done...

Kyle Gospo•6/28/24, 12:52 AM

rpm-ostree status

rpm-ostree status

PPez docs really is a hard one and if people want to contribute they're probably gonn...

Tsubajashi (ツバジャシ)•6/28/24, 12:52 AM

ye, i wouldnt mind anything in particular, really

Jj0rge I mean, I freaking wish it was just like contributing to the k8s docs, but it's ...

indroraOP•6/28/24, 12:53 AM

Then be the half of the equation you’re missing.

Pez•6/28/24, 12:53 AM

what we do for the NZ:P docs is just API mirror the content from github to a server

Importing packages... done Relabeling... done Checking out packages... done error: Checkout python3-typing-extensions-4.9.0-3.fc40.noarch: Hardlinking 91/b18c79d2bde4a094e47e5520982a4373ec0819e1ad2361869c619c3b6d753c.file to typing_extensions.py: File exists

I’ve built a lot around Hugo ( I own an index of U2F keys at https://U2F.garden ) and would be willi

Similar Threads

Similar Threads

Similar Threads