incubator-ooo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache OpenOffice Community > Draft -- Apache OpenOffice Consultants Directory
Date Thu, 27 Sep 2012 16:23:00 GMT
Space: Apache OpenOffice Community (https://cwiki.apache.org/confluence/display/OOOUSERS)
Page: Draft -- Apache OpenOffice Consultants Directory (https://cwiki.apache.org/confluence/display/OOOUSERS/Draft+--+Apache+OpenOffice+Consultants+Directory)


Edited by Rob Weir:
---------------------------------------------------------------------
Proposed disclaimer on page:

{quote}
\\

Although most individual users are able to download and use Apache OpenOffice without any
help, or with the assistance of volunteers on our Forums and mailing lists, some users, especially
corporate users, may have more complex requirements that require commercial services in order
to optimize their deployments.  The following individuals and firms offer services
that may be of interest.   The information provided here was provided by
the entities named here, and is not verified or endorsed by the Apache OpenOffice project. 
We offers this listing as a service to the ecosystem.

Consultants who wish to add their listing here should follow the instructions provided on
this page: XXXX
{quote}
The listing would then be HTML, machine generated by an XLST transform on a XML file we store
in SVN.  For example, the XML could look like this:

{code}
<?xml version="1.0" encoding="UTF-8"?>
<consultants>
    <consultant>
        <name>Joe Bloggs, LLC</name>
        <logo>jbloggs.jpg</logo>
        <discipline>Deployment</discipline>
        <discipline>Migration</discipline>
        <description>Joe Bloggs, LLC provides custom deployment and migration servives
for small and medium business moving to OpenOffice.  We work with the client from initial
        evaluation and piloting, through deployment and beyond.  References and whitepaper
are available on our website.</description>
        <website>http://www/jbloggsllc.com/openoffice.html</website>
        <email>joe@jbloggsllc.com</email>
        <phone>123-456-7890</phone>
    </consultant>

</consultants>

{code}
The schema for this is defined by:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
&nbsp; <xs:element name="consultants">
&nbsp;&nbsp;&nbsp; <xs:complexType>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:sequence>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element maxOccurs="unbounded"
ref="consultant"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </xs:sequence>
&nbsp;&nbsp;&nbsp; </xs:complexType>
&nbsp; </xs:element>
&nbsp;
&nbsp; <xs:element name="consultant">
&nbsp;&nbsp;&nbsp; <xs:complexType>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:sequence>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element ref="name"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element minOccurs="0"
ref="logo"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element maxOccurs="unbounded"
ref="discipline"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element ref="description"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element ref="website"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element minOccurs="0"
ref="email"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:element minOccurs="0"
ref="phone"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </xs:sequence>
&nbsp;&nbsp;&nbsp; </xs:complexType>
&nbsp; </xs:element>
&nbsp;
&nbsp; <xs:element name="name" type="xs:string"/>
&nbsp; <xs:element name="logo" type="xs:anyURI"/>
&nbsp; <xs:element name="discipline" type="discipline"/>
&nbsp; <xs:element name="description" type="description"/>
&nbsp; <xs:element name="website" type="xs:anyURI"/>
&nbsp; <xs:element name="email" type="email-address"/>
&nbsp; <xs:element name="phone" type="xs:string"/>
&nbsp;
&nbsp;
&nbsp;&nbsp; <xs:simpleType name="email-address">
&nbsp;&nbsp;&nbsp; <xs:restriction base="xs:string">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:pattern value="\[^@\]+@\[^\.\]+\..+"/>
&nbsp;&nbsp;&nbsp; </xs:restriction>
&nbsp; </xs:simpleType>
&nbsp;
&nbsp; <xs:simpleType name="description">
&nbsp;&nbsp;&nbsp; <xs:restriction base="xs:string">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:minLength value="0"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:maxLength value="300"/>
&nbsp;&nbsp;&nbsp; </xs:restriction>
&nbsp; </xs:simpleType>
&nbsp;
&nbsp; <xs:simpleType name="discipline">
&nbsp;&nbsp;&nbsp; <xs:restriction base="xs:string">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:enumeration value="Deployment"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:enumeration value="Migration"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:enumeration value="Extensions"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:enumeration value="Training"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:enumeration value="Customization"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <xs:enumeration value="Other"/>
&nbsp;&nbsp;&nbsp; </xs:restriction>
&nbsp; </xs:simpleType>
&nbsp; &nbsp;
</xs:schema>

Consults could submit or edit their entries via a CMS patch, a Bugzilla issue or via the mailing
list.

The HTML that is generated could take advantage of the XSLT capabilities to sort and categorize
the data in several ways, e.g., alphabetically by name, categorized by specialty, etc.&nbsp;
We could evolve this over time, and as needed, based on the number of entries we receive.&nbsp;
For example, at some point, if we have a lot of entries, it might make sense to javascript-enhanced
tables, to allow interactive sorting and filtering.&nbsp; The key thing is to have a clean
separation of the data from the presentation, so we are free to update the website as our
needs grow.&nbsp;

Initially it would probably be a separate build step, i.e., modifying the XML would require
a build, via XALAN, to generate the HTML.&nbsp; But a further refinement would be to then
integrate that with the CMS so it happens automatically.&nbsp; That should be the goal,
but we don't need to get there in one step.


>From a policy perspective, we need to be fair in who we list.&nbsp; We should submissions
from the broader ecosystem of consultants providing services related to Apache OpenOffice.&nbsp;
A proposed list of technical and other requirements is:
# Consultant must submit valid/well-formed description in our defined XML format, or equivalent
information in text form.&nbsp;
# In order to have a good looking website we would have specific logo requirements, perhaps
a common size, formats, no animated GIF's.
# Description text would have a maximum length.&nbsp; We want to avoid someone putting
in page-length descriptions.&nbsp; Description is plain unformatted text, no images, no
hyperlinks.&nbsp; In general, from a security perspective we don't want the possibility
of any user-submitted active content being promoted to the website.
# The listing must not misuse ASF trademarks or be likely to cause confusion with ASF trademarks.&nbsp;
This would apply to the entity name, the email address, website domain, website contents,
description, etc.&nbsp; This would be our main non-technical filter on submissions

Change your notification preferences: https://cwiki.apache.org/confluence/users/viewnotifications.action
   

Mime
View raw message