[lsb-discuss] FW: [dtl_tech_board] OSDL DTL Tech Board: Documentation Framework (Tue, Oct 17)

Jim Zemlin jzemlin at freestandards.org
Wed Oct 4 09:43:12 PDT 2006


Thanks Waldo.  We look forward to your help making the LSB developer
network successful.   

On Wed, 2006-10-04 at 09:01 -0700, Bastian, Waldo wrote:
> This will be an excellent opportunity to look for ways to make this
> Developer Network a bit more successful then. Case in point: when I
> search for "application menu" I get zero hits. Let's look at why that is
> and try to come up with a solution that scales and that provides real
> value to developers.
> 
> Waldo Bastian
> Linux Client Architect - Client Linux Foundation Technology
> Channel Platform Solutions Group
> Intel Corporation - http://www.intel.com/opensource
> OSDL DTL Tech Board Chairman
> 
> >-----Original Message-----
> >From: imurdock at gmail.com [mailto:imurdock at gmail.com] On Behalf Of Ian
> >Murdock
> >Sent: Tuesday, October 03, 2006 5:04 PM
> >To: Bastian, Waldo
> >Cc: lsb-discuss at freestandards.org; dtl_tech_board at groups.osdl.org
> >Subject: Re: [lsb-discuss] FW: [dtl_tech_board] OSDL DTL Tech Board:
> >Documentation Framework (Tue, Oct 17)
> >
> >As I've told OSDL on numerous occasions, the FSG has an active project
> >here, and has for some time (IIRC, the DAM discussion came out of a
> >preliminary description I gave of our plans for the Developer Network).
> >
> >http://developer.freestandards.org/
> >
> >I don't think a duplicate effort here makes much sense.
> >
> >-ian
> >
> >On 10/3/06, Bastian, Waldo <waldo.bastian at intel.com> wrote:
> >> FYI
> >>
> >> Waldo Bastian
> >> Linux Client Architect - Client Linux Foundation Technology
> >> Channel Platform Solutions Group
> >> Intel Corporation - http://www.intel.com/opensource
> >> OSDL DTL Tech Board Chairman
> >>
> >> -----Original Message-----
> >> From: Bastian, Waldo [mailto:waldo.bastian at intel.com]
> >> Sent: Tuesday, October 03, 2006 1:43 PM
> >> To: dtl_tech_board at groups.osdl.org
> >> Subject: [dtl_tech_board] OSDL DTL Tech Board: Documentation
> Framework
> >> (Tue, Oct 17)
> >>
> >> Where: channel #dtl on the FreeNode IRC network
> >> (See http://freenode.net/irc_servers.shtml )
> >>
> >> When: Tue, Oct 17, 8:00am Pacific, 11:00am Eastern, 17:00 Paris,
> 11:00pm
> >> PRC
> >>
> >> Who: People interested in Linux and Open Source documentation for
> >> developers
> >>
> >> The OSDL DTL Technical Board is organizing an IRC session on
> developer
> >> documentation. This is a follow up to discussions that took place on
> the
> >> first OSDL Desktop Architect Meeting [1] and in preparation of DAM
> III
> >> [2] where we would like to move this topic forward.
> >>
> >>
> [1]http://groups.osdl.org/workgroups/dtl/desktop_architects/december_200
> >> 5_meeting
> >>
> [2]http://developer.osdl.org/dev/desktop_architects/index.php/Desktop_Ar
> >> chitects_Meeting-3
> >>
> >> At the first Desktop Architects meeting (Dec, 2005) it was found that
> >> ISVs have difficulty finding documentation, and choosing between
> >> alternative libraries and tools. ISVs would like a site with
> complete,
> >> up-to-date, high-quality Linux documentation. They need roadmaps
> >> (perhaps more than one). There's a lot of misleading documentation
> out
> >> there which discusses deprecated interfaces as if they were
> preferred;
> >> the site should help people avoid those.
> >>
> >> A key concern raised with respect to any portal is the maintenance
> >> burden. The only viable way to guarantee that information in a
> >> development portal is kept up to date is through a strong relation
> with
> >> upstream projects that can provide key information with authority.
> >>
> >> Another requirement to take into account is the desire of OSVs to
> point
> >> their customers to a company site that reflects more closely their
> >> products instead of a third party site.
> >>
> >> The above requirements hint towards a distributed content model that
> >> facilitates multiple distinct content owners with a feedback
> mechanism
> >> to route feedback back to the authorative content owner. It may be
> that
> >> the solution to the documentation problem will not be so much a
> single
> >> documental portal but more so a standardized documentation
> >> infrastructure that the various stakeholders can tap into; as a
> consumer
> >> of content, as a provider of content, or as a combination of the two.
> >>
> >> See
> >>
> http://developer.osdl.org/dev/desktop_architects/index.php/Key_Topics#De
> >> veloper_Portal for more information.
> >>
> >> Preliminary Agenda
> >> * Introduction, who is who
> >> * Documentation Best Practices
> >> * Improvement Areas
> >> * Documentation Aggregation Framework: worth the effort?
> >> * Next Steps
> >>
> >> Waldo Bastian
> >> Linux Client Architect - Client Linux Foundation Technology
> >> Channel Platform Solutions Group
> >> Intel Corporation - http://www.intel.com/opensource
> >> OSDL DTL Tech Board Chairman
> >>
> >> _______________________________________________
> >> lsb-discuss mailing list
> >> lsb-discuss at lists.freestandards.org
> >> http://lists.freestandards.org/mailman/listinfo/lsb-discuss
> >>
> >
> >
> >--
> >Ian Murdock
> >317-863-2590
> >http://ianmurdock.com/
> >
> >"Don't look back--something might be gaining on you." --Satchel Paige
> 
> _______________________________________________
> lsb-discuss mailing list
> lsb-discuss at lists.freestandards.org
> http://lists.freestandards.org/mailman/listinfo/lsb-discuss
> 
-- 
Jim Zemlin
Executive Director, Free Standards Group
2370 Market St. #157
San Francisco, CA 94114
Voice: 415-726-2284
Fax: 415-294-9033
http://www.freestandards.org 





More information about the lsb-discuss mailing list