osdev wiki dedicated git resource

All about the OSDev Wiki. Discussions about the organization and general structure of articles and how to use the wiki. Request changes here if you don't know how to use the wiki.
Post Reply
ajxs
Member
Member
Posts: 27
Joined: Mon Jun 13, 2016 2:25 am
Libera.chat IRC: ajxs
Location: Sydney

osdev wiki dedicated git resource

Post by ajxs »

This is just a thought I had.
When supplying code snippets for wiki articles and tutorials, the wiki provides adequate facilities. However there are times where authors have had to provide entire source files one after another in a single article, this is obviously not ideal. In some other cases authors have provided links to external git repositories to provide more complete examples.
I was thinking that it might be an idea to create a central git repository or account on a VCS hosting service ( github, gitlab, etc ) to be used as a central repository for examples used in the wiki.
In many cases I find it much easier to pore through source code in my own editor than read it online, so being able to check out resources and examples I'm studying is much easier. There is definitely a small administrative overhead, but I think there's some benefits.
User avatar
Solar
Member
Member
Posts: 7615
Joined: Thu Nov 16, 2006 12:01 pm
Location: Germany
Contact:

Re: osdev wiki dedicated git resource

Post by Solar »

I do not see where this would be helpful.

Either your source is open; then you usually already have it residing in a publically accessible repository.

Or your source isn't open. Then there's already places like Pastebin.

Creating / checking into a repository for the sole purpose of posting to OSDev sounds like a pretty nuisance for me. I also take exception at Git being considered some kind of "gold standard" of VCS. It isn't.
Every good solution is obvious once you've found it.
ajxs
Member
Member
Posts: 27
Joined: Mon Jun 13, 2016 2:25 am
Libera.chat IRC: ajxs
Location: Sydney

Re: osdev wiki dedicated git resource

Post by ajxs »

Either your source is open; then you usually already have it residing in a publically accessible repository.
Or your source isn't open. Then there's already places like Pastebin.
Creating / checking into a repository for the sole purpose of posting to OSDev sounds like a pretty nuisance for me.
I didn't intend to introduce any new methodology for posting code to the wiki or sharing user projects. My idea was intended to address the cases where users are already linking external repositories to the wiki. Commonly this contains supplementary code. Or fully assembled examples in the case of the 'Bare Bones' series of articles. My thinking was that it would bring the code provided under shared control, which might help avoid 404's in the case that the hosting user removes their work, or allow for the code to evolve with the associated osdev wiki article.

There's currently only a few wiki pages I could find that link to examples hosted as online source control resources. I should have checked before posting the topic, but you can see them below:
  • https://wiki.osdev.org/Bare_Bones
  • https://wiki.osdev.org/C_Sharp_Bare_Bones
  • https://wiki.osdev.org/Ada_Bare_bones
  • https://wiki.osdev.org/Meaty_Skeleton
  • https://wiki.osdev.org/ARM_Integrator-CP_IRQTimerPICTasksMMAndMods
  • https://wiki.osdev.org/ARM_Integrator-CP_ITPTMME_Phase2
  • https://wiki.osdev.org/Ada_Kalinda
I'll admit a few of these are a little obscure.
Solar wrote: I also take exception at Git being considered some kind of "gold standard" of VCS. It isn't.
You can have this argument with someone else, I'm not interested. I could possibly have used a more generic term in the title, but I think the word 'git' in the title conveys the point adequately.

My original thought was that a central repository would help for users to make corrections and improvement to supplemental code provided for the wiki. Such as that linked to by many of the 'bare bones' articles above. I guess that might be out of the scope of the wiki, and creating a pull request or similar to the repo and updating the wiki might be a bit onerous.
I'm not too upset about this if others aren't interested, it was just an idea! I'm willing to leave the idea here if no one else thinks this resource can be useful.
User avatar
eekee
Member
Member
Posts: 892
Joined: Mon May 22, 2017 5:56 am
Location: Kerbin
Discord: eekee
Contact:

Re: osdev wiki dedicated git resource

Post by eekee »

It might be more appropriate to create sub-pages for the code. That way, anyone with a wiki account can edit them without additional tools. It wouldn't help with viewing code in your editor, but that would be eased if code fields had a button to copy the text. Or if some automation was added to, say, pull all the code from all the sub-pages of an article and present it as files in zip or tar.

More strongly, I'm recently finding Git culture with all its forking to be a real nuisance. This isn't just Git; it could happen with any other DVCS, but Git is where the culture is. I can't find things for all the worthless abandoned forks on Github. The other day I was looking for the fix to Jonesforth to make it run on modern Linux, but I couldn't find it amongst all the abandoned unfixed forks. Also, pull requests are too much beaurocracy for me, making much more work than just fixing the code.
Kaph — a modular OS intended to be easy and fun to administer and code for.
"May wisdom, fun, and the greater good shine forth in all your work." — Leo Brodie
Post Reply