Difference between revisions of "Talk:EnduserFAQ"

From CrossWire Bible Society
Jump to: navigation, search
m
(Is SWORD the same as e-Sword?: new section)
 
(22 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Why was the link the to Z-XML Sword Converter removed?
+
==Discussion about FAQ==
 +
FAQ is for those end user questions which have been asked frequently in sword-support list or some other support forum. It is not for asking random questions. This discussion page is for meta-discussion about the FAQ, not for asking random questions.
  
http://joomla.zykloide.de/Joomla_1.0.10-Stable-Full_Package/component/option,com_docman/task,cat_view/gid,21/
+
Edit the FAQ only if you know what you are doing. Most of those questions which deserve to be there are there already. Give new proposals for the FAQ here (in this discussion page) first. Small factual or orthographical corrections are welcome without discussion.
  
http://www.bibleworkplace.de/content/view/1/4/
+
Questions should be as general as possible. Names of programs, modules etc. should be given only as examples (preferably in the answer) unless the question/answer is strictly about a specific named subject and cannot be generalized.
--[[User:84.159.172.31|84.159.172.31]] 05:00, 24 June 2007 (MDT)
+
  
I wondered why many other changes were reverted also. Some of them did enhance the quality of the FAQ.
 
  
I understand that we have to keep the FAQ as Frequently Asked Questions. It should not be Questions Which Someone Has Asked Once or Never Asked Questions Which Someone Wants To Answer Here. There are already some questions/answers there which are not very frequent. It makes the page more difficult to use for end users. All really Frequently asked questions are there.
+
=== Module-specific questions ===
  
From now on, if someone wants to add/remove a question, I suggest that we discuss it here in this talk page.
+
It might be good to have a question "How do I report a problem with a module". I think the right answer it to point them to Jira and file a bug under Modules. But that requires membership. Chris, if you don't mind, I'll leave this up to you, since you are the Module "Pumpkin Holder".
  
Questions about Z-XML converter are not frequent. If it's included it could be inserted under general converter section (question about e-sword should be changed to be more general).
+
As to the naming of specific modules, I agree that the questions should be more general. It might be reasonable to list specific ones in the answer if they are a frequent subject of the question.
 
+
-- Eeli Kaikkonen
+
 
+
 
+
I don't remember seeing the Z-XML converter myself, but I would probably have removed it if I had. I apologize that I can't fully elaborate since I don't recall my particular objections to the Z-XML converter, but I didn't consider it something we ought to recommend that users use. (One way or another, it is NOT reasonable to consider it an End-User tool, and the FAQ, being for End-Users, is not an appropriate place to link to it.) I'll elaborate on my reservations if I get a chance to take another look at the program. In any case, we have a Zefania to OSIS converter that (IMNSHO) does a better job even though it's still a work in progress (but what isn't).
+
 
+
-- Osk
+
 
+
Some of the stuff I added was reverted and some removed. As a community process, I expect that some of that will happen. However, I didn't like that they were anonymously made. I suggest that we make our changes while logged in and add a brief comment to each edit.
+
  
 
-- DM
 
-- DM
  
 +
===Accented texts===
 +
I'm working on a couple of good texts (MorphGNT & Tisch from morphgnt.org) which I hope to post tonight. I know accented LXXes exist, but I don't know their quality or look forward to merging with our existing database. I also don't know of accented copies of most of our other Greek texts, so we'd still be stuck telling people that what they see is all we have. -- Osk
  
Where is the Zefania to OSIS converter? --[[User:84.159.195.26|84.159.195.26]] 12:33, 25 June 2007 (MDT)
+
I think this renders the question/answer unnecessary. Let's see if people ask about the nonexisting accents when those modules have been public for some time. --[[User:Eelik|Eelik]] 08:00, 10 October 2007 (MDT)
  
The recent OSIS converters I wrote are sitting [http://crosswire.org/ftpmirror/pub/sword/utils/perl/ here]. I'm still going to hold off on any major announcement for a couple of reasons: First, they still need a little work. Second, I don't want people flooding me with modules they created with these converters since I've already got everything I would consider posting converted (whether or not I've actually gotten it online yet).
+
===Can I publish a text in Sword format?===
 +
Every now and then someone asks if it's possible to publish a work in our format. It has been asked at least about translations and commentaries. We could give a short positive answer in FAQ and give some links to helpful pages. It is so-and-so if this an end user or developer question but mostly the people who ask this seem not to be developers. --[[User:Eelik|Eelik]] 08:00, 10 October 2007 (MDT)
  
-- Osk
+
== Unlinking of this page from the front page ==
  
Reverting some other's changes may possibly happen if someone copies the text, edits it and later commits it without checking first. We just have to be careful.
+
Today I unlinked this page from the CrossWire front page and created a static copy. I think this will be teh better solution as long as we keep an eye on major changes. All improvements should go into here and will from time to time get copied over. The risk obviously is that we again keep forgetting about updating. But then we can change that again. [[User:Refdoc|refdoc]]:[[User_Talk:Refdoc|talk]] 09:04, 3 December 2008 (UTC)
  
Some wiki FAQs are meant to be edited by end users. That can confuse some users so that they add their questions here though the purpose is that the developers gather the proper questions. This whole thing would be much easier if we just required logging in. I don't see any reason why anonymous editing would be important. Well, I'm not logged in either...  --Eeli
+
== Is SWORD the same as e-Sword? ==
  
I put back in my changes. I'll also see if mediawiki allows us to have some pages require login. I don't know if that is something that we want to do. This page should be our "official" answers to "frequent" questions, not a place to ask questions.
+
I get asked this question more often than any others when I start talking about CrossWire. It therefore certainly qualifies to go in the '''F'''AQ. [[User:David Haslam|David Haslam]] 10:33, 9 January 2010 (UTC)
 
+
-- DM
+
 
+
== Module-specific questions ==
+
 
+
I just removed a question placed in the FAQ about why the Swahili Bible doesn't contain the book of Philippians. (I don't happen to know the answer, but I'll check into it.) Anyway, we should probably such module-specific questions out of the FAQ, even if it means creating another FAQ-type page for those questions. I know there are some questions currently address specific modules, but that's a fault in the questions themselves, which happen to address general issues by naming specific modules.
+
 
+
-- Osk
+
 
+
It might be good to have a question "How do I report a problem with a module". I think the right answer it to point them to Jira and file a bug under Modules. But that requires membership. Chris, if you don't mind, I'll leave this up to you, since you are the Module "Pumpkin Holder".
+
 
+
As to the naming of specific modules, I agree that the questions should be more general. It might be reasonable to list specific ones in the answer if they are a frequent subject of the question.
+
 
+
-- DM
+

Latest revision as of 10:33, 9 January 2010

Discussion about FAQ

FAQ is for those end user questions which have been asked frequently in sword-support list or some other support forum. It is not for asking random questions. This discussion page is for meta-discussion about the FAQ, not for asking random questions.

Edit the FAQ only if you know what you are doing. Most of those questions which deserve to be there are there already. Give new proposals for the FAQ here (in this discussion page) first. Small factual or orthographical corrections are welcome without discussion.

Questions should be as general as possible. Names of programs, modules etc. should be given only as examples (preferably in the answer) unless the question/answer is strictly about a specific named subject and cannot be generalized.


Module-specific questions

It might be good to have a question "How do I report a problem with a module". I think the right answer it to point them to Jira and file a bug under Modules. But that requires membership. Chris, if you don't mind, I'll leave this up to you, since you are the Module "Pumpkin Holder".

As to the naming of specific modules, I agree that the questions should be more general. It might be reasonable to list specific ones in the answer if they are a frequent subject of the question.

-- DM

Accented texts

I'm working on a couple of good texts (MorphGNT & Tisch from morphgnt.org) which I hope to post tonight. I know accented LXXes exist, but I don't know their quality or look forward to merging with our existing database. I also don't know of accented copies of most of our other Greek texts, so we'd still be stuck telling people that what they see is all we have. -- Osk

I think this renders the question/answer unnecessary. Let's see if people ask about the nonexisting accents when those modules have been public for some time. --Eelik 08:00, 10 October 2007 (MDT)

Can I publish a text in Sword format?

Every now and then someone asks if it's possible to publish a work in our format. It has been asked at least about translations and commentaries. We could give a short positive answer in FAQ and give some links to helpful pages. It is so-and-so if this an end user or developer question but mostly the people who ask this seem not to be developers. --Eelik 08:00, 10 October 2007 (MDT)

Unlinking of this page from the front page

Today I unlinked this page from the CrossWire front page and created a static copy. I think this will be teh better solution as long as we keep an eye on major changes. All improvements should go into here and will from time to time get copied over. The risk obviously is that we again keep forgetting about updating. But then we can change that again. refdoc:talk 09:04, 3 December 2008 (UTC)

Is SWORD the same as e-Sword?

I get asked this question more often than any others when I start talking about CrossWire. It therefore certainly qualifies to go in the FAQ. David Haslam 10:33, 9 January 2010 (UTC)