|
Replies:
5
-
Last Post:
Jul 17, 2009 1:49 PM
by: alysson
|
Threads:
[
Previous
|
Next
]
|
|
Posts:
5,504
From:
US
Registered:
3/9/05
|
|
|
|
[docs-discuss] "Writing Open Source" project & BoF at OSCON
Posted:
Jul 16, 2009 5:00 PM
|
|
Looking through the schedule for next week's OSCON in San Jose, I saw
an interesting BoF on open source documentation:
http://en.oreilly.com/oscon2009/public/schedule/detail/10217
It's related to a cross-project open source docs conference held last
month:
http://www.writingopensource.com/
Has anyone from the OpenSolaris docs community been involved in this?
(Since one the many things I do is update documentation for X.Org,
including translating ancient scrolls from lost languages like troff
to DocBook, I was considering checking it out.)
BTW, for those local, OSCON BoF's are free to attend if you get the
free exhibit hall pass:
http://en.oreilly.com/oscon2009/public/content/free
--
-Alan Coopersmith- alan dot coopersmith at sun dot com
Sun Microsystems, Inc. - X Window System Engineering
_______________________________________________
docs-discuss mailing list
docs-discuss at opensolaris dot org
|
|
|
Posts:
307
From:
US
Registered:
5/1/08
|
|
|
|
Re: [docs-discuss] "Writing Open Source" project & BoF at OSCON
Posted:
Jul 17, 2009 8:22 AM
in response to: alanc
|
|
Thanks for pointing this out! I just registered with writingopensource.com.
Would be great to get a report on that BOF session from bay area locals
able to attend.
-alan
Alan Coopersmith wrote:
> Looking through the schedule for next week's OSCON in San Jose, I saw
> an interesting BoF on open source documentation:
> http://en.oreilly.com/oscon2009/public/schedule/detail/10217
>
> It's related to a cross-project open source docs conference held last
> month:
> http://www.writingopensource.com/
>
> Has anyone from the OpenSolaris docs community been involved in this?
>
> (Since one the many things I do is update documentation for X.Org,
> including translating ancient scrolls from lost languages like troff
> to DocBook, I was considering checking it out.)
>
> BTW, for those local, OSCON BoF's are free to attend if you get the
> free exhibit hall pass:
> http://en.oreilly.com/oscon2009/public/content/free
>
>
_______________________________________________
docs-discuss mailing list
docs-discuss at opensolaris dot org
|
|
|
|
|
Posts:
58
From:
US
Registered:
12/7/06
|
|
|
|
Re: [docs-discuss] "Writing Open Source" project & BoF at OSCON
Posted:
Jul 17, 2009 10:29 AM
in response to: alanm
|
|
Ditto! I just registered, too. Thanks, Alan.
Alysson
On 07/17/09 09:22, alan mcclellan wrote:
> Thanks for pointing this out! I just registered with
> writingopensource.com.
>
> Would be great to get a report on that BOF session from bay area
> locals able to attend.
>
> -alan
>
>
> Alan Coopersmith wrote:
>> Looking through the schedule for next week's OSCON in San Jose, I saw
>> an interesting BoF on open source documentation:
>> http://en.oreilly.com/oscon2009/public/schedule/detail/10217
>>
>> It's related to a cross-project open source docs conference held last
>> month:
>> http://www.writingopensource.com/
>>
>> Has anyone from the OpenSolaris docs community been involved in this?
>>
>> (Since one the many things I do is update documentation for X.Org,
>> including translating ancient scrolls from lost languages like troff
>> to DocBook, I was considering checking it out.)
>>
>> BTW, for those local, OSCON BoF's are free to attend if you get the
>> free exhibit hall pass:
>> http://en.oreilly.com/oscon2009/public/content/free
>>
>>
> _______________________________________________
> docs-discuss mailing list
> docs-discuss at opensolaris dot org
_______________________________________________
docs-discuss mailing list
docs-discuss at opensolaris dot org
|
|
|
|
|
Posts:
307
From:
US
Registered:
5/1/08
|
|
|
|
Re: [docs-discuss] "Writing Open Source" project & BoF at OSCON
Posted:
Jul 17, 2009 11:06 AM
in response to: alysson
To: Communities » documentation » discuss
|
|
Alysson, did you see that have an open source style guide project? Wonder how it compares to our style guide cheat sheet?
|
|
|
|
|
Posts:
58
From:
US
Registered:
12/7/06
|
|
|
|
Re: [docs-discuss] "Writing Open Source" project & BoF at OSCON
Posted:
Jul 17, 2009 1:49 PM
in response to: alanm
|
|
It looks like they have a skeleton framework in place. Only two of the
following sections (shown in bold) (listed at
http://writingopensource.com/open-source-style-guide) have any content:
Interestingly, the short References section includes the Sun Global
Glossary and Read Me First! A Style Guide for the Computer
Industry (which is Sun's external trade version of its internal
style guide).
Our cheat sheet has about 8-10 (printed) pages of fairly well-developed
content. Here's the TOC (from http://opensolaris.org/os/community/documentation/doc_collab/style_guide/editorial_guidelines/):
Alysson
On 07/17/09 12:06, alan mcclellan wrote:
<pre wrap="">Alysson, did you see that have an open source style guide project? Wonder how it compares to our style guide cheat sheet?
</pre>
|
|
|
|
|
Posts:
37
From:
US
Registered:
3/22/07
|
|
|
|
Re: [docs-discuss] "Writing Open Source" project & BoF at OSCON
Posted:
Jul 17, 2009 11:18 AM
in response to: alanc
|
|
On 07/16/09 17:00, Alan Coopersmith wrote:
> Looking through the schedule for next week's OSCON in San Jose, I saw
> an interesting BoF on open source documentation:
> http://en.oreilly.com/oscon2009/public/schedule/detail/10217
>
> It's related to a cross-project open source docs conference held last
> month:
> http://www.writingopensource.com/
>
> Has anyone from the OpenSolaris docs community been involved in this?
>
> (Since one the many things I do is update documentation for X.Org,
> including translating ancient scrolls from lost languages like troff
> to DocBook, I was considering checking it out.)
>
> BTW, for those local, OSCON BoF's are free to attend if you get the
> free exhibit hall pass:
> http://en.oreilly.com/oscon2009/public/content/free
>
>
I have registered for this and will be attending the BoF session on Monday.
Thanks,
Jyothi
_______________________________________________
docs-discuss mailing list
docs-discuss at opensolaris dot org
|
|
|
|
|
