Interested in improving this site? Please check the To Do page.
To Do
The purpose of this page is to organize the work required to improve this website.
How to get started
Click the Login link at the top right of each page. On the Login page, click the Register link to sign up for a new account. Although you will be prompted for an email address, there is currently no confirmation or approval step in the signup process. Once you are logged in, you should be able to edit the content of this site via the “edit page” link at the top of each page.
If you want to create a new page, think carefully about where it should be put. It’s possible but not trivial to move the page later without breaking internal links. Once you have decided on the future location of the page, enter the URL manually into your browser. Instead of a 404 error, you should receive a custom error page with the option of creating the page (assuming you are logged in).
If you want to make major changes to the site, e.g. add a page on a new topic or rewrite a full page, it might be a good idea to leave a note about your intentions on this page.
Site Structure
I’ve been thinking about the structure of this site and I think I’ve found what’s been bugging me. We call “developers” those working on the kernel code. But Frontier’s a development environment, so users are developers (scripters) as well. I think we need to do something both with the main menu and our sectioning to be clear where there’s resources for scripting-level development and kernel-level development. I’d recommend changing the left menu (top portion) to Home (more common than Start), Download, Documentation, Project Coding (rather than “developers”), Discussion (rather than mailing lists), and links. What do you think? I’m also thinking about how to make the Docs page clearer, but I’m not there yet. — David Gewirtz 2006/03/30 18:58
I already replaced “Start” with “Home”. I see your point about scripters vs. kernel developers, but I don’t find “Project Coding” any more descriptive than just “Developers”, so I switched to “Kernel Developers” instead. Other possibilities I considered and rejected: “Kernel Development”, “Developer Zone”, “Dev Zone”. Using “Discussion” instead of “Mailing Lists” would perhaps make sense if the page contained more than links to mailing lists. As it is, “Mailing Lists” seems to be the most appropriate label to me. Maybe later we can replace it with a more general “Community” page. So the navlinks now are: Home, Downloads, Documentation, Mailing Lists, Kernel Developers, Links. Maybe not perfect yet, but good enough for now, IMHO.— André Radke 2006/03/31 06:31
I like “kernel developers”. That’s nice and clear. — David Gewirtz 2006/04/03 21:58
Section: Home
The home page needs to achieve several things: introduce the main features of Frontier to potential new users, explain the history leading to the open source release, explain the organization of this site, invite volunteers, and include a couple of news items at the bottom to show that there’s some activity on this project. I think this is a job for a native speaker. Prior art: Firefox and Python — André Radke 2006/03/25 11:46
Section: Documentation
This section is meant to provide documentation about all aspects of Frontier, with the exception of developing the Frontier kernel itself (in C). This should eventually be the largest section of the site. If you want to contribute, please leave a note here. — André Radke 2006/03/31 06:31
We’ve got some verbs that are showing up in the SourceForge repository that aren’t reflected in the Updated Frontier Verbs documentation. Please go through the various verbs and if you’ve created or modified them, update their documentation appropriately. — David Gewirtz 2006/03/29 20:38
Section: Kernel Developers
This section is for documenting the internals of the Frontier kernel. The target audience is anybody who would like to contribute code to the kernel. This is the section I intend to focus on. If you want to contribute, please leave a note here. — André Radke 2006/03/25 12:03
New page: Using the frontierkernel repository. Please review and improve. — André Radke 2006/03/26 21:40
New page: Hacking the Frontier kernel. In progress, feel free to add topics you would like me to cover. — André Radke 2006/03/26 21:41
New pages: I imported my brain dumps from kernel.scripting.com to make them editable. How to add new kernel verbs , TCP/IP networking, Compiling and Executing UserTalk Scripts, Database Structure, Database File Format, Multi-Threading. — André Radke 2006/04/01 11:52
Section Title update: make it reflect the intended target audience, matching the left nav. — Adrian Russell-Falla 2007/07/23 18:21
Section: Downloads
All future releases should use the Files architecture on SourceForge. The version numbering scheme needs to be explained here. — André Radke 2006/03/25 11:26
The Compile Farm section needs to go because automatic compiles are currently broken. — André Radke 2006/03/25 11:26
The Other Builds section needs to have links added. I’m not sure this section actually needs to point to any builds besides the initial binary release on kernel.scripting.com. — André Radke 2006/03/25 11:26
Section: Links
Somebody needs to go through the list of links to make sure they work and maybe improve the description of some links. — André Radke 2006/03/25 11:33
Sweet - I can go thru the links and check-em for ya. Should I just go to it or do I need clearance? — FredenFromSweden 2007-04-16
OK - couldn’t wait for a reply. I just <del>ed out any links that didn’t work and listed the error after.Thanks. Nice job. If you wanted to organize and group the links better, add some more current ones, and provide better descriptions, we’ll certainly appreciate it. — David Gewirtz 2007/05/02 14:46