Logged-In As
ACCOUNT
Not Logged In
Write an article about FreeBSD on MacBooks based on a FreeBSD wiki page FreeBSD
Status: Closed Time to complete: 72 hrs Mentors: Chris Rees, Jakub Klama, Glen Barber Tags: Apple, FreeBSD, documentation, SGML, Mac, DocBook, MacBook

Description of task

The FreeBSD operating system can be run on Apple MacBooks. There are some special things that are required when doing so, which are described in the following FreeBSD wiki page: http://wiki.freebsd.org/AppleMacbook

The contents of that wiki page must be described in an article for our user community.

Task requires: 

A FreeBSD system (in a VirtualBox Virtual Machine) installed on your computer. 
Knowledge of the documentation guidelines for the FreeBSD project: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/
Check out a copy of the documentation tree from the documentation repository to get the source code for the chapter

Uploaded Work
File name/URL File size Date submitted
http://utkarshpant.blogspot.com/2011/12/go... n/a December 03 2011 09:39 UTC
Apple MacBooks on FreeBSD (Wiki page article for GCI 2011 Task).txt 12.9 KB December 29 2011 05:10 UTC
Comments
Vedant Chakravarthy on November 21 2011 13:04 UTC Task Claimed

I would like to work on this task.

Vedant Chakravarthy on November 21 2011 13:05 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

Sina Sabet on November 21 2011 14:08 UTC Task Claimed

I would like to work on this task.

Sina Sabet on November 21 2011 14:08 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

Will Zhang on November 21 2011 14:22 UTC Task Claimed

I would like to work on this task.

Will Zhang on November 21 2011 14:42 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

Lynne Ji on November 22 2011 01:08 UTC Task Claimed

I would like to work on this task.

Lynne Ji on November 22 2011 01:11 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

Wojciech A. Koszek on November 22 2011 01:18 UTC Reason for removing the claim

Lynne,

Would you be willing to explain me why did you remove the
claim for this task?

I saw 4 people claiming/unclaiming the task and I want to
understand what's the problem.

Wojciech

Will Zhang on November 22 2011 01:43 UTC Why I removed the Claim

Well Mr. Koszek the problem for me is that I am not running a FreeBSD OS but windows 7. I guess I jumped the gun and claimed this task quickly before actually reading the requirements. Sorry if I bothered you with claiming the task.

Wojciech A. Koszek on November 22 2011 08:20 UTC Re: Why I removed the Claim

Ok, thanks. Fair enough. I just wanted to know if we have a problem with Google Melange portal. Thanks.

Callam Delaney on November 22 2011 16:26 UTC Hi

Hey there, how long of an article would you be looking for here?

Daniel M. on November 22 2011 17:35 UTC Task Claimed

I would like to work on this task.

Eitan Adler on November 22 2011 18:32 UTC How long of an article

The article should be based on http://wiki.freebsd.org/AppleMacbook, as long as it covers everything mentioned there.

Eitan Adler on November 22 2011 18:32 UTC How long of an article

The article should be based on http://wiki.freebsd.org/AppleMacbook, as long as it covers everything mentioned there.

Jakub Klama on November 22 2011 23:00 UTC Task Assigned

This task has been assigned to Daniel M.. You have 72 hours to complete this task, good luck!

Melange on November 25 2011 23:00 UTC Initial Deadline passed

Melange has detected that the initial deadline has passed and it has set the task status to ActionNeeded. You have 24 hours to submit work before it is reopened.

Melange on November 26 2011 23:00 UTC Task Reopened

Melange has detected that the final deadline has passed and it has reopened the task.

deivid on November 28 2011 11:46 UTC Task Claimed

I would like to work on this task.

deivid on November 28 2011 11:47 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

kendhia on November 29 2011 17:10 UTC Help

I've a problem after installing freebsd (in vmwar workstation) , i really did not understand how to enter to the desktop .

Utkarsh Pant on November 30 2011 10:22 UTC Task Claimed

I would like to work on this task.

Utkarsh Pant on November 30 2011 10:28 UTC The length of the article.....

Hi there, Mr. Koszek, can you please let me in on this - Should we use sources other than the one you have specified in the task, or must we stick to the article on the web page specified?

Utkarsh Pant on November 30 2011 10:40 UTC One more doubt.....

Once again, when I'm done with my article, how do I upload it, because I don't see any way to upload it as of now.....


 Please advise on this.


Thank you!

Eitan Adler on November 30 2011 12:36 UTC Task Assigned

This task has been assigned to Utkarsh Pant. You have 72 hours to complete this task, good luck!

Chris Rees on November 30 2011 14:52 UTC Uploading the article

Hi Utkarsh,


You'll need to create an article, but I'm happy to deal with the version control aspect if you send me a copy of the source via email (crees@FreeBSD.org).  Be sure to copy in gjb@ and jceel@ too.


You could use http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/articles/contributing/article.sgml?rev=1.511 as a starting point.


You're welcome to use any sources you like, but they must be correct and the actions must be repeatable!


Chris

Eitan Adler on November 30 2011 16:22 UTC Be careful

Be sure to cite any sources you use outside of the wiki page. We need to be careful of copyright issues.

Utkarsh Pant on December 3 2011 09:40 UTC Ready for review

The work on this task is ready to be reviewed.

Utkarsh Pant on December 3 2011 10:50 UTC Hi, Chris, and all other mentors,

I have done a fresh article here, and have included a last bit about contributing to FreeBSD, based on the link Chris posted. Please let me know if I was wrong in what I percieved I had to do, and do let me know. Thank you, once again, for all the help. 


Anyway, please go through my article, and please let me know if I need to add anything more, or change the matter of the article. Also, I haven't used any outside sources, other than the one originally given (The wiki page), so I don't think there should be problems or issues with copyright?


Regards,


Utkarsh

Melange on December 3 2011 12:36 UTC No more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Chris Rees on December 4 2011 08:52 UTC Deadline extended

The deadline of the task has been extended with 2 days and 0 hours.

Chris Rees on December 4 2011 08:56 UTC Article format

Hi Utkarsh,


Thanks for your email, and sorry for the delay in getting back to you; I still don't seem to be receiving updates from melange.  Since this isn't your fault, I've extended the deadline by 48 hours.


You've certainly made a nice looking article, however I think you may have misunderstood the task description; the requirement was for a Docbook style article, as linked to above, that we can include with the FreeBSD documentation.


If you'd like some extra help, please hop into #freebsd-soc on EFNet and people are there to give pointers; keep showing us what you're doing so you don't spend a lot of time going down the wrong avenue....


Good luck,


Chris

Glen Barber on December 4 2011 19:48 UTC Writing style

Hi Utkarsh,


In addition to the feedback Chris provided, I have a few comments regarding documentation style.


We try to avoid "you" and "your" in FreeBSD documentation as much as possible.  For example:


"If your wireless network hangs or seems to hang,"


would be better suited for FreeBSD documentation if stated as:


"If the wireless network seems to hang..."


Otherwise, nice work on this.


Chris has already extended the deadline, but if you need more time, please let us know.


Thanks!


Glen

Utkarsh Pant on December 5 2011 11:47 UTC Thanks Glen

Hi Glen,


Thank you for your feedback, and I'll see to it that I put in all of the advise all of you have given me! I'll upload the link pretty soon, so that you can take a look at my re-done work, and let me know if I go wrong once again.


 


Thanks once again!


Utkarsh

Utkarsh Pant on December 5 2011 11:50 UTC About more time

Hi glen,


Once again, I'll surely let you know if I need any extensions in time, (you know, 9th grade is tough, and there's a LOT of school work :D  )


Thank you,


Utkarsh

Melange on December 6 2011 17:49 UTC No more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Glen Barber on December 11 2011 05:58 UTC Task Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

Utkarsh Pant on December 12 2011 11:03 UTC Non-completion

Hi Glen,


I haven't been able to work on the task, but I'm getting on with it today.


Sorry,


Utkarsh

Glen Barber on December 12 2011 11:44 UTC Re: Non-completion

Hi Utkarsh,


No problem - the deadline had passed, but was automatically extended when I changed the state of this.


Thanks for working on this!


Glen

Glen Barber on December 12 2011 11:45 UTC Deadline extended

The deadline of the task has been extended with 2 days and 0 hours.

Melange on December 14 2011 11:50 UTC Task Reopened

Melange has detected that the final deadline has passed and it has reopened the task.

Utkarsh Pant on December 14 2011 11:53 UTC Finishing

Hi Glen, Chris,


I just finished up with the task, but was seconds late in putting up the ink, as my net went down, but can you approve my request for taking up the task, and then see the re-done work? Really sorry for the delay in getting the work done, as my tests were on.


Sorry, and thanks,


Utkarsh

Utkarsh Pant on December 14 2011 12:04 UTC Task Claimed

I would like to work on this task.

Glen Barber on December 14 2011 14:28 UTC Task Reopened

This task has been Reopened.

Glen Barber on December 14 2011 14:29 UTC Whoops...

Utkarsh,


I clicked the wrong button, and accidentally republished the task.  Can you please re-request to work on it, so we can assign it to you again?


Sorry about that.


Glen

Utkarsh Pant on December 14 2011 15:09 UTC Task Claimed

I would like to work on this task.

Glen Barber on December 14 2011 15:10 UTC Task Assigned

This task has been assigned to Utkarsh Pant. You have 72 hours to complete this task, good luck!

Utkarsh Pant on December 14 2011 15:17 UTC Ready for review

The work on this task is ready to be reviewed.

Glen Barber on December 16 2011 15:16 UTC Latest article review

Hi  Utkarsh,


Overall, the aritcle looks fine.  Just a few comments.


1.)  When referencing manual pages, we should use the manual page macro, rather than, for example, 'fdisk(8)' directly in the document.  The manual page macro is in the format: '&man.MANUAL.SECTION;', where 'MANUAL' is replaced by the name of the manual page, and 'SECTION' is replaced by the section in which the 'MANUAL' appears.  So, using fdisk(8) as an example, the proper macro would be: &man.fdisk.8; .


2.)  When referencing 'FreeBSD', the '&os;' macro should be used, similar to the above example.  (Note that there are some exceptions to this, for example '&os;' does not work as expected when used in URLs.)


3.)  The '<para>' sections are too long, and can likely be broken down into different '<sectN>' sections.  But this is easy enough to fix if you don't/can't do it.


There are some other, very minor, things througout the document that need to be addressed before it can be included in the handbook.  Nothing major.


Nice work.


Can you please save the resulting article as a plain-text file, and upload it here so we have a hard-copy available?


Regards,


Glen

Melange on December 17 2011 15:10 UTC No more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Glen Barber on December 23 2011 00:09 UTC Task Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

Utkarsh Pant on December 28 2011 12:55 UTC Ready for review

The work on this task is ready to be reviewed.

Chris Rees on December 28 2011 13:03 UTC Text file

Hm, did you upload a text file as Glen suggested?


Chris

Utkarsh Pant on December 29 2011 03:41 UTC About the text file...

Hi Chris,


I accidentally closed up the upload button by marking the task as complete, but I have the text file ready to upload, so what should I do? Should I email it to you, or could you re-open the upload button so I can upload it?


Thanks,


Utkarsh

Eitan Adler on December 29 2011 03:55 UTC Deadline extended

The deadline of the task has been extended with 0 days and 3 hours.

Eitan Adler on December 29 2011 03:56 UTC I gave you more time

I gave you another three hours to upload the work (I hope this works with your time zone). If you still are not able to upload it I guess email would work.

Utkarsh Pant on December 29 2011 05:12 UTC File uploaded!

Hi Eitan,


 


Thanks for extending the deadline! I have uploaded the file up there.


 


Thanks,


Utkarsh

Melange on December 29 2011 11:04 UTC No more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Glen Barber on January 2 2012 00:38 UTC Task Closed

Congratulations, this task has been completed successfully.