Universal Blue•2y ago

YESSSSSSS

j0rgeOP•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...

indrora•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

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

Check the GitHub for it out.

It’s all frontmatter controlled.

j0rgeOP•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

j0rgeOP•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

j0rgeOP•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...

indrora•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

j0rgeOP•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

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

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

j0rgeOP•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

indrora•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...

j0rgeOP•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

j0rgeOP•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...

indrora•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

indrora•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

j0rgeOP•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

j0rgeOP•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 statusrpm-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 ...

indrora•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

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

and we also accept submissions from people up-front because it's not like they all use github

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

U2F.garden has had a handful of people submit fixes and updates over time

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

j0rgeOP•6/28/24, 12:54 AM

hah. This would be like the 4th time. But I'm down if you are, if you two wanna grab what we have and make it look awesome, and it's all in github and actioned up, I'd +1 that.

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

i dont really have a problem with the lack of contributors with the docs tbh

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

the bazzite buzz newsletter stuff on the other hand lol

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

YESSSSSSS

Similar Threads

Similar Threads

Similar Threads