basically we want to slurp the `documentation` tags from discourse, take those markdown files, pipe

P

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

oh that's a sinch

J

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

T

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

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

P

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

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

P

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

and you are supporting a good crew

J

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

I

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

J

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

we ran our own static site generator for a while

P

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

the forum posts are just pinned topic headers anyway

P

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

the ones they're directly referencing i assume

J

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

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

J

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

I

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.

T

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

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

P

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

^

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

J

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

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

P

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

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

T

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.

T

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

true

J

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

P

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

next time somebody does offer

T

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

i like reading my own docs

P

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

like this kind person above

P

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

I

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

You’d be surprised

P

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

make sure they're happy with putting that effort in

T

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

P

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

most people don't stick around for nothing

I

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

W

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

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

J

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

yeah but this is nothing like our day jobs, haha

P

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

W

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

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

P

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

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

J

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

K

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

rpm-ostree status

rpm-ostree status

rpm-ostree status

rpm-ostree status

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

T

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

I

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

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

P

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

P

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

I

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.

J

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.

T

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

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

T

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

the bazzite buzz newsletter stuff on the other hand lol

T

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

oh boy newsletter
i would really love to help, but in that regards im really bad haha

T

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

but docs are fine

P

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

i think it's better having a handful of contributors because you want your docs to be really strictly written

KKyle Gospo `rpm-ostree status`

W

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

~$ rpm-ostree status
State: idle
Deployments:
● ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:26e7df3e555a1ad6fb7824c01ae43130bc9447d63274810c2f3d7455374f198d
                  Version: 40.20240625.0 (2024-06-27T02:01:58Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager
                   Pinned: yes

  ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:0c4b7e972517bcffe2de7d0770728bc428ed0940249e39ecaa7d8ba0d89b9008
                  Version: 40.20240624.0 (2024-06-24T17:17:05Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager

~$ rpm-ostree status
State: idle
Deployments:
● ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:26e7df3e555a1ad6fb7824c01ae43130bc9447d63274810c2f3d7455374f198d
                  Version: 40.20240625.0 (2024-06-27T02:01:58Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager
                   Pinned: yes

  ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:0c4b7e972517bcffe2de7d0770728bc428ed0940249e39ecaa7d8ba0d89b9008
                  Version: 40.20240624.0 (2024-06-24T17:17:05Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager

~$ rpm-ostree status
State: idle
Deployments:
● ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:26e7df3e555a1ad6fb7824c01ae43130bc9447d63274810c2f3d7455374f198d
                  Version: 40.20240625.0 (2024-06-27T02:01:58Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager
                   Pinned: yes

  ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:0c4b7e972517bcffe2de7d0770728bc428ed0940249e39ecaa7d8ba0d89b9008
                  Version: 40.20240624.0 (2024-06-24T17:17:05Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager

~$ rpm-ostree status
State: idle
Deployments:
● ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:26e7df3e555a1ad6fb7824c01ae43130bc9447d63274810c2f3d7455374f198d
                  Version: 40.20240625.0 (2024-06-27T02:01:58Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager
                   Pinned: yes

  ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-gnome-nvidia:latest
                   Digest: sha256:0c4b7e972517bcffe2de7d0770728bc428ed0940249e39ecaa7d8ba0d89b9008
                  Version: 40.20240624.0 (2024-06-24T17:17:05Z)
          LayeredPackages: coolercontrol edk2-ovmf libldm liquidctl openrazer-meta qemu razergenie samba sunshine
                           ulauncher virt-manager

Jj0rge hah. This would be like the 4th time. But I'm down if you are, if you two wanna ...

I

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

What’s the history on docs with bazzite/ublue?

P

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

trying to bring in as many people as possible will just end up with low quality / AI submissions all over the place

basically we want to slurp the `documentation` tags from discourse, take those markdown files, pipe

Similar Threads