More cleanup in the Handbook today… Some of it was in the Additional Resources section where I cleaned out the dead links and added the ones I could think of off the top of my head. I’m sure I missed many good resources (editing for 8 hours tends to empty out the top of one’s head…)
You can help us make a comprehensive list of resources. We’re looking for blogs, forums, news sites, tutorials, planets, etc. that deal primarily with FreeBSD and/or PC-BSD. Please leave a comment with the URLs you would like to see included in this list. We’re also looking for non-English resources for those users who would like access to resources in their native language.
Here is a summary of today’s many changes to the doc structure and Handbook.
Most of the content from the main page of the wiki has been moved into the Handbook. The following sections were integrated:
- Using the Ports Console Jail
- Working with FreeBSD Ports & Packages
- Keeping PC-BSD Updated
- Jail Management with The Warden
- Setting up a PC-BSD Thin Client Server
- Legacy PBI Access (deleted as no longer relevant)
- Dual Booting
- Reporting Bugs
- Using the PC-SysInstall backend (scriptable installs)
- Using the PBI Builder to make a PBI from a FreeBSD
- PortPBI Module Builder Guide
- PBI Request List
Several of these sections had their screenshots and text updated.
In particular, these Handbook sections had a first pass at updating their existing, out-of-date content:
There are bound to be broken links that I’ve missed, so please leave a comment as you find them. Please note that the entire Handbook is an active work in progress (changing hourly). There are some notes (IN CAPS so they stand out) on missing info and the Figures won’t be named and numbered until the content is more stable. The size of the figures will also be standardized once we figure out which size works best in a print layout.
If there is a specific section that you’re waiting to be updated (as you need that info) or if you have suggestions for sections that are missing but needed, leave a comment so they can be prioritized in the editing queue.
You may notice some changes on the main website today as we try to consolidate all of the doc pieces into one cohesive whole. The ultimate goal is to have a “one stop shop” for how to use/troubleshoot PC-BSD that is available both online and as an offline copy included with each release.
A link to the FAQS has been added. We’re thinking of a sane way of integrating these into the Handbook, but for now the search utility is quite handy. Having an easy to find link on the website makes sense.
The Migrate section has been moved to the Handbook so it no longer appears in the red main menu at the top of each page. It has been replaced by a link to the Handbook, so you can easily access it from any page of the website.
The graphic artist is working on the image–a new banner indicating 8.1 as the latest release should be up in the next day or so.
Please let us know if you find any broken links anywhere on the website so these can be attended to.
We could use your help on the Burning the installation DVD section of the PC-BSD Users Handbook. If you use graphical burning software on Windows, Unix/BSD/Linux, or Mac OS X, please let us know if any of the screenshots are out of date or if we are missing a popular (and preferably, freely available) burning application. We want the burning process to be as easy as possible for new users.
If you find an out of date screenshot for an application you use, please send an updated png. To prevent us from inadvertently using copyrighted images, indicate that you took the screenshot from your own system and that you give us permission to include it in the Handbook.
Thanks to everyone who left comments regarding feature and documentation suggestions. Keep these coming so we can start prioritizing and integrating your suggestions.
Spending today going through the PC-BSD Users Handbook. The plan thus far is to read it through while addressing broken links, obviously outdated information (such as version numbers) and fixing grammatical errors. After the first pass-through, I’ll have a better idea of which sections need updated material and what documentation does not yet exist.
This is where you can help out, too. Have you gone to the Handbook to find out how to do something and couldn’t find it? Have you done something cool on your PC-BSD system that you think should be added to the Handbook? Are there some new features in 8.x that you haven’t found in the Handbook yet? Let us know! We’ll definitely need help with reviewing content and writing new content.
Welcome to the PC-BSD blog! Here we hope to keep you up-to-date with what’s happening with the PC-BSD operating system and what features are in the works. We also want to hear your comments and feedback so we can find out what is useful and interesting to PC-BSD users and become aware of any pain points or requests for new features.
It’s also my first day of working full time with the PC-BSD community. I have a large laundry list of things that need doing, starting with filling in some documentation gaps. I’d definitely like to hear from you–especially if you have a task to perform in PC-BSD and you can’t find any documentation on how to do it. Or if you are aware of tasks that have changed in 8.x where the documentation has not been updated yet.
We also welcome suggestions on topics you would like to see covered in this blog. So, feel free to leave a comment and to subscribe to this blog. If you can’t find a way to subscribe using your favourite method, leave a comment and we’ll see if we can add it.