$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1

$Id: guidelines.txt,v 1.20 2003/06/02 01:47:07 smith Exp $



xml-doc list guidelines

-------------------------------------------------------------------

   These guidelines are sent as a Welcome message to new xml-doc

   subscribers and once every four weeks to all current

   subscribers.  Please save these guidelines for later reference

   and take a moment to review them now, including the PRIVACY

   POLICY and NO-SPAM NOTICE at the end.



TABLE OF CONTENTS

-------------------------------------------------------------------

   0. TOPIC GUIDELINES

   1. ACCESSING THE XML-DOC WEB SITE

   2. POSTING AND REPLYING TO MESSAGES

   3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

   4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

   5. DEALING WITH E-MAIL ATTACHMENTS

   6. RECEIVING FURTHER HELP



   A. PRIVACY POLICY

   B. NO-SPAM NOTICE

   C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

   D. CHANGELOG

-------------------------------------------------------------------



  0. TOPIC GUIDELINES

  -----------------------------------------------------------------

     xml-doc is for discussion of XML/SGML and document authoring,

     particularly authoring of documentation for computer software

     and hardware. Topics for which list members have a specific

     interest include:



       * XML editing applications

       * Single-sourcing for multiple audiences/delivery formats

       * XML-based content management systems

       * DocBook and other document-oriented markup vocabularies

       * Converting legacy documents

       * Organizational strategies for structured authoring

       * Document analysis and markup model design/refinement

       * Transitioning from older (e.g. FrameMaker) environments

       * Publishing (transforming and delivering XML content)



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  1. ACCESSING THE XML-DOC WEB SITE

  -----------------------------------------------------------------

     As a member of the xml-doc mailing list, you also have access

     to the xml-doc Web site:



       http://groups.yahoo.com/group/xml-doc/



     To use some features of the Web site, you also need to

     choose a username and password and register with Yahoo Groups.



  2. POSTING AND REPLYING TO MESSAGES

  -----------------------------------------------------------------

     To send a message to all the members of the mailing list,

     e-mail it to:



       xml-doc@yahoogroups.com



     To post a message via the Web, visit:



       http://groups.yahoo.com/post/xml-doc/



     By default, when you reply to a message, the reply is sent to

     all members of the list. If you want to reply just to the

     author of a posted message, please specify only the author's

     e-mail address in the "To:" field in your reply.



     Here are a few general tips for posting and replying to

     messages delivered to online mailing lists:



     a. Use meaningful subject lines.



        Try not to use generic, uninformative subject lines such as

        "Easy question," "Help needed," "Urgent," and so on.

        Instead, use meaningful subject lines that will quickly

        make sense to the people whose help you are trying to get.



     b. Quote only relevant parts of messages when replying.



        When replying to a message, please don't quote the author's

        entire message unless it's really necessary. Instead,

        quote just the parts to which you are directly replying, or

        quote only enough to establish a context for your reply.



     c. Avoid idiomatic and colloquial English.



        Be sensitive to the fact that a significant number of

        subscribers to any English-language online mailing list are

        non-native speakers of English. By avoiding idiomatic and

        colloquial language, you ensure that your message will have

        a higher degree of international readability.



     Please also take a moment to read the NOTE ON TOPIC DRIFT,

     TROLLS, AND FLAMES at the end of this message.



  3. READING MESSAGES VIA THE WEB AND ACCESSING THE MESSAGE ARCHIVE

  -----------------------------------------------------------------

     All messages posted to the list are simultaneously posted to

     xml-doc website and are immediately available at:



       http://groups.yahoo.com/messages/xml-doc/



     All messages are also automatically archived. To search

     the archive, use the search box on the message page. To browse

     the archive by month, visit the xml-doc main page:



       http://groups.yahoo.com/group/xml-doc/



  4. UNSUBSCRIBING, RECEIVING DIGESTS, AND PUTTING MAIL ON HOLD

  -----------------------------------------------------------------

     You can unsubscribe at any time by e-mailing a message to



       xml-doc-unsubscribe@yahoogroups.com



     To specify that you want to receive a digest of messages once

     a day instead of receiving messages one at a time as they are

     posted, send a blank e-mail message to:



       xml-doc-digest@yahoogroups.com



     To remain a list member, but receive no mail (for example, if

     you plan to read messages by accessing the archive at the

     xml-doc Web site or if you want to stop your xml-doc e-mail

     while you are on a vacation), send a blank e-mail message to:



       xml-doc-nomail@yahoogroups.com



     To switch back from the "digest" or "no mail" settings to the

     "normal" setting, send a blank e-mail message to:



       xml-doc-normal@yahoogroups.com



     You can also change your delivery settings from the xml-doc

     Web site:



       http://groups.yahoo.com/subscribe/xml-doc/



  5. DEALING WITH E-MAIL ATTACHMENTS

  -----------------------------------------------------------------

     Any files that members attach to a message are stripped out

     before the message is distributed to the list; you cannot send

     or receive attachments via the list.



     If you have a file you would like to make available to the

     other members of the list, upload it directly to the file

     sharing area of the xml-doc Web site:



       http://groups.yahoo.com/files/xml-doc/



     All interested members can then access or download the file at

     their convenience.



  6. RECEIVING FURTHER HELP

  -----------------------------------------------------------------

     If you have questions about the list itself and need to have

     them answered by a real person, send them to:



       xml-doc-owner@yahoogroups.com



  Regards,



  Michael Smith

  xml-doc moderator and list owner



..................................................................



  A. PRIVACY POLICY

  -----------------------------------------------------------------

     The xml-doc list moderator has a complete list of e-mail

     addresses for all xml-doc subscribers, but will not provide

     any subscriber e-mail addresses or personal information to any

     third party, at any time, for any purpose. Yahoo Groups itself

     has a separate privacy policy:



       http://privacy.yahoo.com/



     Read their policy carefully and make sure it is acceptable to

     you. If it's not, you should unsubscribe from the list.



  B. NO-SPAM NOTICE

  -----------------------------------------------------------------

     Please don't post messages to xml-doc that are not related

     directly to XML/SGML and document authoring. Specific types of

     messages that are inappropriate on the list include:



     * Product or service announcements that have an excessive

       amount of unobjective marketing hype



     * Any "for sale" announcements; for example, if you have used

       computer equipment or software you're trying to re-sell, or a

       domain name you want to unload, posting an announcement to

       xml-doc is not an appropriate way to try to find a buyer



     You should also read the the Yahoo Terms of Service document,

     which contains information about their policy toward spam, along

     with other things.



       http://docs.yahoo.com/info/terms/



  C. NOTE ON TOPIC DRIFT, TROLLS, AND FLAMES

  -----------------------------------------------------------------

     Before posting or replying to a message, please remember this

     list's stated purpose -- as outlined in the TOPIC GUIDELINES --

     and show consideration for the fact that there are subscribers on

     the list from a wide variety of professional backgrounds, and

     that many people aren't going to be nearly as interested as you

     might be in any particular discussion that drifts away from the

     topic guidelines, no matter how important/relevant you may

     personally believe the particular topic drift to be.



     [0] http://www.catb.org/~esr/jargon/html/T/topic-drift.html



     xml-doc is a relatively low-noise list, and relatively free

     from trolls[1] and flames[2] and flame bait[3].



     [1] http://www.catb.org/~esr/jargon/html/T/troll.html

     [2] http://www.catb.org/~esr/jargon/html/F/flame.html

     [3] http://www.catb.org/~esr/jargon/html/F/flame-bait.html



     To help keep the noise level down, don't fan the flames, and

     avoid feeding the trolls if/when they appear (a much better

     strategy is simply to ignore them).



  D. CHANGELOG

  -----------------------------------------------------------------



     2003-06-02  <smith@...>



       * updated jargon-file URLs



     2003-05-02  <smith@...>



       * formatting tweak



       * changed vim foldlevel



       * minor reformatting



       * formatting, minor updates



       * topic drift, etc. section updated



     2002-10-04  <smith@...>



       * added section about topic drift, trolls, and flames (in another place)



       * added section about topic drift, trolls, and flames



     2002-07-02  <smith@...>



       * changed 'DocBook and other DTDs' to 'DocBook and other markup

vocabularies'



       * changed 'DTD creation' to 'markup model design'



     2002-04-24  <smith@...>



       * minor tweaks



       * removed spam warnings



       * expanded tabs



       * added more no-spam warnings



       * no-spam.txt: New file.



     2002-04-03  <smith@...>



       * fixed minor typo



     2002-01-02  <smith@...>



       * branches:  1.1.1; Initial revision



       * added Id keyword



       * New file.



// this file best viewed with Vim 6.1 or greater ;)

// vim:foldmethod=indent:foldlevel=1