View source

<H2>FAQ: Help Resources for [[AbiWord|AbiWord]]</H2>

There are a variety of resources that can provide help with [[AbiWord|AbiWord]].  

<H3>Contents</H3>


==== "Official" Resources
====

==== [[AbiWord|AbiWord]] Website
====

www.abisource.com

==== [[AbiWord|AbiWord]] TWiki and FAQ
====
Pages on this, the [[AbiWord|AbiWord]] TWiki, including the [[AbiWordFAQ|AbiWordFAQ]] -- click on Search, above, or go to the [[AbiWordFAQ|AbiWordFAQ]] and skim the list of topics

==== User''s Mail List and Archives
====

The user''s mail list: abiword-user@abisource.com -- subscribe by sending an email with only the word "subscribe" in the body to abiword-user-request@abisource.com

The [http://www.abisource.com/mailinglists/abiword-user archives] of the user''s mail list.  You can also search these using Google by specifying "site:www.abisource.com" in your search query -- this will not work for very recent posts as they probably will not have been indexed by Google yet.

==== Developer''s Mail List and Archives
====

The developer''s mail list: abiword-dev@abisource.com -- subscribe by sending an email with only the word "subscribe" in the body to abiword-dev-request@abisource.com

The [http://www.abisource.com/mailinglists/abiword-dev archives] of the developer''s mail list.  You can also search these using Google by specifying "site:www.abisource.com" in your search query -- this will not work for very recent posts as they probably will not have been indexed by Google yet.

==== Bugzilla
====

Post your bug report (or RFE) on [http://bugzilla.abisource.com the [[AbiWord|AbiWord]] Bugzilla] -- see also [http://www.abisource.com/support/bugs/ [[AbiWord|AbiWord]]: Report a Bug].

==== Other Resources
====

There are other helpful sites on the Internet, some of which are listed here:

* [http://twiki.org/cgi-bin/view/Wikilearn/[[AbiWord|AbiWord]] [[WikiLearn|WikiLearn]]: [[AbiWord|AbiWord]]] ;-)
* &lt;if you know of a site or resource -- add it here, move this to the next line -- for extra credit add new sites in alphabetic order ;-) > 

==== Adding to the [[AbiWord|AbiWord]] TWiki
====

You are encouraged to add new pages to this TWiki as you see the need for additional documentation.  This includes FAQ and non-FAQ pages.

==== Bug vs. FAQ
====

However, there is / should be a distinction between bugs and FAQs.	 Bugs should be reported on the [[AbiWord|AbiWord]] Bugzilla (see [[#Bugzilla]]), and FAQs should be added to a new page on this TWiki with an appropriate prefix (see [[[[AbiWordFAQ|AbiWordFAQ]]#Creating_New_FAQ_Pages_or_Catego]]).

What''s the difference between a bug and a FAQ?

_"I know it when I see it"_

Here''s some guidance from Dom Lachowicz (maintainer of [[AbiWord|AbiWord]]):

&lt;quote>  
What goes in a FAQ vs. what goes in bugzilla -- some basic considerations:

	1 If you reasonably think more information might be needed in order to solve the problem, it goes in bugzilla. All crash bugs except for the infamous "unix font" crash bug belong in bugzilla and not a FAQ.
	1 If a problem is already in bugzilla, a mention about it or a workaround *might* belong in a FAQ. If it is in a FAQ, the problem *should* already be in bugzilla.
&lt;/quote> 

Here''s a first cut I made (this will probably be deleted in the near future -- maybe I''m in a "thought collecting" mode at this point in time):

Sometimes it can be a fine line.  A FAQ is:
* more general than a bug (??)
* more enduring than a bug -- _a bug might be a "mistake" in a current version of [[AbiWord|AbiWord]] that is (or becomes) known and is expected to be fixed in the near future -- a FAQ might deal with an ongoing problem (e.g., the fonts problem) for which there is no quick or easy solution and which may be expected to persist for some time_

-- Main.[[RandyKramer|RandyKramer]] - 05 Sep 2002
[[Category:To Convert]]