OSDev.org
https://forum.osdev.org/

Not stable code / tools on wiki
https://forum.osdev.org/viewtopic.php?f=8&t=44694
Page 1 of 1

Author:  nexos [ Mon Jun 28, 2021 3:17 pm ]
Post subject:  Not stable code / tools on wiki

Hello,
I have been looking through the wiki, and noticed a trend where people slap up some code and leave it for others to debug. There have been countless higher half kernel threads, presumably because the existing the tutorial just does it wrong. The Rapsberry Pi tutorial had a blatantly obvious error (maybe it was a copytrap. Who knows?) I think it should be known that all code that gets put on the wiki should get tested beforehand. We are trying to make this friendly for new OSDevers :) The other concern I've had is people promoting their unstable projects on the wiki, recommending that people use them. I have seen some month old and year old projects be promoted on the wiki. In the system level world, even if something works on QEMU, Bochs, and your machines, it probably doesn't work on 40% of real machines out there. Hence, potentially unstable things should not get put on the wiki IMO.
This is just a trend I've seen recently that I think should be known about.
nexos

Author:  iansjack [ Mon Jun 28, 2021 11:30 pm ]
Post subject:  Re: Not stable code / tools on wiki

Are you volunteering to check code?

Author:  nexos [ Tue Jun 29, 2021 5:34 am ]
Post subject:  Re: Not stable code / tools on wiki

iansjack wrote:
Are you volunteering to check code?

I mean, if it would make the wiki a better place, once I get my build system set up, I certainly would check some code that would get used very often (like the Higher Half bare bones).

Author:  bzt [ Tue Jun 29, 2021 11:05 pm ]
Post subject:  Re: Not stable code / tools on wiki

nexos wrote:
Hello,
I have been looking through the wiki, and noticed a trend where people slap up some code and leave it for others to debug. There have been countless higher half kernel threads, presumably because the existing the tutorial just does it wrong.
Could be.
nexos wrote:
The Rapsberry Pi tutorial had a blatantly obvious error (maybe it was a copytrap. Who knows?)
If I recall correctly, I have been distracted by my little boy when I was writing that page, sorry about that. Wasn't bad for copytrap either BTW ;-) As far as I know the Raspberry Pi Bare Bones page has been fixed several months ago, but if by any chance not, let me know.
nexos wrote:
I think it should be known that all code that gets put on the wiki should get tested beforehand.
As @iansjack said, if you volunteer for that, you'll get all the help from us. It's a noble and quite a big task to test EVERYTHING on the wiki.
nexos wrote:
The other concern I've had is people promoting their unstable projects on the wiki, recommending that people use them.
Agreed. I had the same concern about Limine, and removed it (causing a little fiasco because people didn't understand that unstable projects has no place on the wiki). I'm glad to see that it finally had a stable release and was put back on the wiki, however I still have concerns about how well tested it is.
nexos wrote:
I have seen some month old and year old projects be promoted on the wiki.
Agreed. For example I had issues with getting the tools for C#, because it lead to a dead link. (If I remember correctly has been fixed since, but still not sure if that old tool works with the latest toolchains. Maybe someone developing on Win can confirm that.)
nexos wrote:
In the system level world, even if something works on QEMU, Bochs, and your machines, it probably doesn't work on 40% of real machines out there. Hence, potentially unstable things should not get put on the wiki IMO.
I share your concern. I've spent years with a lot help from many many contributors to get BOOTBOOT tested on as many real machines as possible. I'd say this was a much bigger task than to write the loader itself, and I take the opportunity to say thanks to all contributors and testers here too. I'm still not convinced that Limine or BootProg for example has that kind of test coverage, but I better not edit their wiki pages because people wouldn't understand why I did it (not everybody share our concerns, keep that in mind). That being said I think they deserve a place on the wiki, we shouldn't remove them just because we're not sure how much testing their creators put in them, but we should distinguish untested software from tested ones somehow.

Cheers,
bzt

Author:  nexos [ Wed Jun 30, 2021 7:31 am ]
Post subject:  Re: Not stable code / tools on wiki

bzt wrote:
I'm still not convinced that Limine or BootProg for example has that kind of test coverage

Well, Limine actually worked on all my machines! I have to say, the team over there has done a great job. Give it a few more tests, and I'd be all for promoting it on the wiki! BOOTBOOT, I haven't tested it yet, I probably will soon. BOOTBOOT has been around for awhile, so it has enough tests to be stable, IMO.

Author:  nexos [ Wed Jun 30, 2021 11:28 am ]
Post subject:  Re: Not stable code / tools on wiki

I just tested the x86 Higher Half Barebones, and there was a problem in it. I was getting an error from GRUB stating "entry point isn't in a segment". I set the early text and data section to be allocatable, and that fixed it! I will go change the wiki now.

Author:  Korona [ Sun Aug 01, 2021 6:27 am ]
Post subject:  Re: Not stable code / tools on wiki

Limine is pretty stable, it's in Arch Linux' AUR and people actually use it to boot their day-to-day OSes (not only hobby ones, see here.

There are also various other bootloaders available that replicated Limine's boot protocol on platforms other than x86 (e.g., Sabaton has PinePhone and experimental iPhone support).

Author:  nexos [ Sun Aug 01, 2021 7:16 am ]
Post subject:  Re: Not stable code / tools on wiki

Yes, Limine is fine, but I am having a problem with POSIX-UEFI being on the wiki. Its been out for only a couple months, has had several issues on the forum, not to mention that all the UEFI wiki pages practically market it. Hence, for this reason, I don't think that there should be links all over the wiki for it.

Page 1 of 1 All times are UTC - 6 hours
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group
http://www.phpbb.com/