OSDev.org

The Place to Start for Operating System Developers
It is currently Thu Mar 28, 2024 5:23 pm

All times are UTC - 6 hours




Post new topic Reply to topic  [ 43 posts ]  Go to page 1, 2, 3  Next
Author Message
 Post subject: Wiki Improvement Coordination
PostPosted: Tue Apr 28, 2015 5:57 am 
Offline
Member
Member
User avatar

Joined: Wed Mar 21, 2012 3:01 pm
Posts: 930
In this topic, we will be discussion particular issues with the osdev wiki and how to solve them. Nominate articles for deletion or a serious revision. Locate articles that should go into the Lovecraftian category. There's crazy, misleading, and wrong parts of the wiki. Let's get rid of them.

I suggest you use the random article feature. That'll bring you to the obscure corners of the wiki. See also the Wiki Wish List.

For information on how to edit the wiki, see http://forum.osdev.org/viewtopic.php?f=8&t=677.
For the manual of style, see http://wiki.osdev.org/OSDev_Wiki:Manual_Of_Style.

Let's hear some concrete suggestions for wiki improvement.


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Tue Apr 28, 2015 7:53 am 
Offline
Member
Member

Joined: Tue Jan 20, 2015 9:01 am
Posts: 119
I think this is a good idea. I will take a break from my OS to spend some time on the wiki.

As for the suggestions part, maybe wiki could be improved if all those wanted pages existed. Maybe we should provide trivial information for beginners, but also explain things more in depth? And even bolding/underlining important parts on pages could be helpful, maybe.

Waiting for your suggestions too.

Regards,
glauxosdev


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Tue Apr 28, 2015 9:51 am 
Offline
Member
Member
User avatar

Joined: Thu Mar 27, 2014 3:57 am
Posts: 568
Location: Moscow, Russia
I think, that we need pages about x2APIC and XNU (OS X kernel). I think I could take care about XNU, because I'm reading "Mac OS X and iOS Internals: To the Apple's Core" by Jonathan Levin.

_________________
"If you don't fail at least 90 percent of the time, you're not aiming high enough."
- Alan Kay


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Tue Apr 28, 2015 11:35 am 
Offline
Member
Member
User avatar

Joined: Sat Jan 15, 2005 12:00 am
Posts: 8561
Location: At his keyboard!
Hi,

sortie wrote:
Let's hear some concrete suggestions for wiki improvement.


For a start, this sounds like a good idea to me:

Kevin wrote:
At Lowlevel, the quality of the questions was improved a lot after we had abandoned the old "copy this code" style tutorials for individual topics (actually, they are still around, but much less prominent) and guided people towards a new coherent series of good tutorials. "Good" means that they don't just offer code (they do, but usually it's incomplete so that you have to think a bit and can't just c&p), but explain what options you have, where to get information on each of them and how you can integrate the pieces best. In the first part, the provided code is rather complete, and as the series progresses, it becomes less and you have to fill in more by yourself using the links that are given. This way it didn't duplicate the topic-specific articles, but is more like a "guided tour" through the wiki.


Specifically, I like the idea of something that explains all the options, and branches off to "option specific" pages (which converge again as the reader progresses). For example:

Code:
             Intro
               |
            Project Goals (e.g. knowing what yours is)
               |
            OS types
            /   |    \
  Monolithic  Micro  Exo-kernel
            \   |    /
       Languages/Toolchains
            /   |    \
     Assembly  GCC   CLANG
            \   |    /
            Boot loaders
              /    \
            GRUB   Roll your own
              \    /
           Memory Management
                .
                .
                .


I also agree with something iansjack said - we probably do need more links to official documentation (if/where possible); and some sort of explanation on how to obtain documentation if a direct link isn't possible (e.g. things like UEFI specs and ARM manuals that require you register and/or sign an "adoptors agreement" before you can download; and places like t13.org who won't give you official specifications for free but will let you download an "almost as good" draft).


Cheers,

Brendan

_________________
For all things; perfection is, and will always remain, impossible to achieve in practice. However; by striving for perfection we create things that are as perfect as practically possible. Let the pursuit of perfection be our guide.


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Tue Apr 28, 2015 4:43 pm 
Offline
Member
Member
User avatar

Joined: Mon Jun 16, 2014 5:33 pm
Posts: 213
Location: Costa Rica
I'll touch some begginer-related pages. I won't change any already-proven-to-work algorithm, and I'll inform on this thread all changes I make, so they can be undone if necessary.

Edit:
BTW, did you saw on the wiki's Main Page at the bottom that...
OSDev Wiki wrote:
This page was last modified on 16 December 2011, at 03:45.


Edit 2:
I suggest that some type of Wiki Formatting Codelines shall be created.

_________________
Happy New Code!
Hello World in Brainfuck :D:
Code:
++++++++[>++++[>++>+++>+++>+<<<<-]>+>+>->>+[<]<-]>>.>---.+++++++..+++.>>.<-.<.+++.------.--------.>>+.>++.


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Tue Apr 28, 2015 9:50 pm 
Offline
Member
Member

Joined: Sun Sep 21, 2014 7:16 am
Posts: 104
KemyLand wrote:
Edit 2:
I suggest that some type of Wiki Formatting Codelines shall be created.

If you mean writing wiki pages, then it already exists, see http://wiki.osdev.org/OSDev_Wiki:Manual_Of_Style.


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Wed Apr 29, 2015 12:10 am 
Offline
Member
Member
User avatar

Joined: Tue Dec 25, 2007 6:03 am
Posts: 734
Location: Perth, Western Australia
As a note of a set of articles that need a good prune/merge/rework - The ATA related ones, mostly because there's a lot of duplicated information there, and hints/important information spread around within the usless or repeated stuff.

_________________
Kernel Development, It's the brain surgery of programming.
Acess2 OS (c) | Tifflin OS (rust) | mrustc - Rust compiler
Currently Working on: mrustc


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Wed Apr 29, 2015 12:55 am 
Offline
Member
Member

Joined: Wed Oct 30, 2013 1:57 pm
Posts: 306
Location: Germany
This needs some serious rework: Writing a memory manager.
Are these needed? Socket, Select, Message Passing Tutorial.
This should be moved into the main namespace and put at the best spot on the Extended Main Page: Naively Closed Source.

How about creating a temporary TODO wiki page in a user namespace for coordinating?

Let the discussion begin!

_________________
managarm


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Wed Apr 29, 2015 2:52 am 
Offline
Member
Member
User avatar

Joined: Wed Oct 18, 2006 3:45 am
Posts: 9301
Location: On the balcony, where I can actually keep 1½m distance
KemyLand wrote:
I'll touch some begginer-related pages. I won't change any already-proven-to-work algorithm, and I'll inform on this thread all changes I make, so they can be undone if necessary.

Edit:
BTW, did you saw on the wiki's Main Page at the bottom that...
OSDev Wiki wrote:
This page was last modified on 16 December 2011, at 03:45.

That page consists almost exclusively of templates, and after a few incidents with both vandals and people not understanding what that means, there's also protection on that page with the following message:
Expanded Main Page wrote:
<!-- For your daily editing, go to http://wiki.osdev.org/Category:Main_Page_Templates - this page is locked mainly to prevent accidental breakage -->


Main Page itself is a redirect, so if you have a replacement main page ready, that redirect can be easily updated.

_________________
"Certainly avoid yourself. He is a newbie and might not realize it. You'll hate his code deeply a few years down the road." - Sortie
[ My OS ] [ VDisk/SFS ]


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Wed Apr 29, 2015 3:04 am 
Offline
Member
Member
User avatar

Joined: Wed Mar 21, 2012 3:01 pm
Posts: 930
no92: See the http://wiki.osdev.org/Wish_List. I would prefer if coordination discussion happened here. I can edit the first post as needed. The article stubs on some POSIX system interfaces are okay, they can be expanded in the future. The select article documents an obsolescent interface, it should be replaced by an article about poll(2), and a generic article about power efficient waiting. I'm okay with moving Naively Closed Source into the main namespace, but I wrote it as a non-objective rant, which people might disagree heavily with. I'm a bit on the fence about putting that into the main namespace as generic advise.

thepowersgang: I agree the ATA articles needs work. I used them recently, I should work on them. I'd like for there to be more emphasis on the proper PCI & DMA approach rather than hard-coded IO ports & PIO. We also need an article on AHCI.


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Fri May 01, 2015 5:41 am 
Offline
Member
Member

Joined: Tue Jan 20, 2015 9:01 am
Posts: 119
And what about tutorials in the wiki? I think many of them are broken (such as "Real mode assembly I", to which I added org statement and stack setup). Maybe should we work on them?

Also, I think we could get divided into groups, each of them could be responsible for a domain. For example, Roman, I and two others could be responsible for "CPU Registers" (I created "CPU Registers x86" and Roman "CPU Registers x86-64", of course there are also other architectures). Another group could be responsible for something second, and another for something third etc. And moderators could moderate all the domains.

Regards,
glauxosdev


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Fri May 01, 2015 7:00 am 
Offline

Joined: Fri Dec 26, 2014 3:28 pm
Posts: 5
no92 wrote:
This should be moved into the main namespace and put at the best spot on the Extended Main Page: Naively Closed Source.


This would be a great thing! And it would also be nice to put a link for the #osdev IRC channel(although I have joined it only a couple of times myself).

I am a beginner, so I cannot contribute that much in writing new articles, but I can help edit, merge and fix the old ones. I'd also suggest to reskin at least the wiki, since it is the "entry point"( :D ) to the osdev world and the default one gives me that discouraging "old and abandoned site" feel. I can actually do it myself if you can help me with some information on how the wiki skin is structured.

_________________
I'm not a native English speaker, feel free to correct me.


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Sun May 03, 2015 3:09 am 
Offline
User avatar

Joined: Wed May 22, 2013 12:02 am
Posts: 20
Location: The Netherlands
Shouldn't Intel_Ethernet_i217 be added under the Network cards and communicating devices section on the Expanded_Main_Page?


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Sun May 03, 2015 12:22 pm 
Offline
Member
Member
User avatar

Joined: Mon Jun 16, 2014 5:33 pm
Posts: 213
Location: Costa Rica
alexander wrote:
Shouldn't Intel_Ethernet_i217 be added under the Network cards and communicating devices section on the Expanded_Main_Page?

Done

_________________
Happy New Code!
Hello World in Brainfuck :D:
Code:
++++++++[>++++[>++>+++>+++>+<<<<-]>+>+>->>+[<]<-]>>.>---.+++++++..+++.>>.<-.<.+++.------.--------.>>+.>++.


Top
 Profile  
 
 Post subject: Re: Wiki Improvement Coordination
PostPosted: Mon May 04, 2015 8:27 pm 
Offline

Joined: Thu Sep 20, 2012 6:46 pm
Posts: 24
Hi. The asm goto code in the Interrupt Service Routines article is buggy, and I have better working code which handles not only correct interrupt acknowledge, but also compatibility with multitasking and handling exceptions which push an error code. But I think it would be better to create a separate page for that and substitute the original asm goto code with a little explanation and a link to the new page.
May I modify it?


Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 43 posts ]  Go to page 1, 2, 3  Next

All times are UTC - 6 hours


Who is online

Users browsing this forum: No registered users and 21 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group