Samba FAQ

Fri Oct 20 02:42:19 GMT 2000

Well.. the basic idea is to use xml, and probably php as parser for it.
Here is my arguement / idea:
By using xml, we can have each Q/A in one file, with misc. information
even one per q/a per language. This enables us to have small vi-able files,
which everyone can edit, and submit.

Each entry (q/a) is linked to a section such as "printing", "ntdom", "general"
etc. They also have author information (name, email), revision, date changed and
language. The rev. gives us the possibility to warn someone that's reading the
german language entry that he/she is reading rev. 3 while the english is rev. 4
[per definition every entry (and most updated) is available in english. ]

BTW: section-sample in norwegian ("no") enclosed.

see the "how-to-submit.xml" file as example of an entry and "sections.xml" as
example of the sections / toc. The id allows us to alter sorting / order without
changing all entries.

The types of url's intended are "outside", for sites like www.linux.com,
"samba" for pages within the /samba on all samba mirrors. That is, if the
samba team are interrested to make such a FAQ part of their web-pages.
and "lists" which should refer to the list-archive. This allows us to point
people in the right direction for further information.

Suggestions are welcome. 
also please note that the two .xml files are me playing with the idea, and
the final content / structure can be very different, as long as tou all come
with your ideas.

I was hoping that someone of the samba-team would read this and comment on it.

--Anders

On Fri, Oct 20, 2000 at 12:30:57PM +1000, David Bannon wrote:
>At 04:12 PM 19/10/2000 -0500, Anders C . Thorsen wrote:
>>
>>There is a official FAQ at samba.org/samba/docs/FAQ. I'm unaware of how often
>>this FAQ is updated, etc.
>
>Well, I'm doing so at this very moment. I'm particularly addressing Samba
>2.2.0, ie not the various development streams. Its being written in yodl so
>it can be translated to other formats although this is currently under
>review (or at least I hope it under review).
>
>Have a look at http://bioserve.latrobe.edu.au/samba for a draft of both PDC
>HowTo and FAQ. Comments are very welcome.
>
>>Please, let me know if I'm stepping someone on their toes with this
>suggestion,
>
>Not at all, the current one is actually mis-leading because of the changes
>that are taking place all over that samba concept. I do like the kernel
>Cousin idea, there is a Samba one but there seems little Samba PDC
>interest. Hmm....
>
>David
>
>
>
>------------------------------------------------------------
>David Bannon                      D.Bannon at latrobe.edu.au
>School of Biochemistry            Phone 61 03 9479 2197
>La Trobe University, Plenty Rd,   Fax   61 03 9479 2467
>Bundoora, Vic, Australia, 3083    http://bioserve.latrobe.edu.au
>------------------------------------------------------------
>..... Humpty Dumpty was pushed !
-------------- next part --------------
<?xml version='1.0'?>

<section
	number="1"
	id="general"
	title="General Samba questions"
	maintainer="Anders C. Thorsen"
	email="anders at aae.wisc.edu"
	rev="0"
	date="2000-10-19"
	lang="en"
>

Genereal questions related to samba and samba developement should go here.
</section>

<section
	number="2"
	id="printing"
	title="Printing"
	lang="en"
	rev="0"
	date="2000-10-19"
>
Questions related to printing support trough samba
</section>
<section
	id="printing"
	title="Printing"
	lang="no"
	rev="0"
	date="2000-10-19"
>
Sp&oslash;rsm&aring;l ang&aring;ende printing i samba.
</section>

<section
	number="3"
	id="filesharing"
	title"File-sharing"
	lang="en"
	rev="0"
	date="2000-10-19"
>
File-sharing with samba.
</section>

<section
	number="4"
	id="os"
	title="OS-Specific information"
	lang="en"
	rev="0"
	date="2000-10-19"
>
Questions specific to operatingsystems.
</section>

<section
	number="5"
	id="security"
	title="Sequrity questions"
	lang="en"
	rev="0"
	date="2000-10-19"
>
Security questions.
Note that this section does only cover frequently asked questions,
which hopefully should give a sequrity overview. Please note that
questions such as "How can I make my Linux box secure" should not
be directed to the list.
</section>

<section
	number="6"
	id="nonsamba"
	title="Non-Samba Questions"
	lang="en"
	rev="0"
	date="2000-10-19"
>
These are questions that are related to samba in such a way that they are
frequently asked (hence FAQ :) )

-
Important: For general information on Windows NT/2000 and 9x/ME
should be retreved from Microsoft and their Knowledgebase. This icludes
registry settings, etc.
</section>

<section
	number="7"
	id="ntdomain"
	title="Samba in Windows NT/2000 Domains"
	lang="en"
	rev="0"
	date="2000-10-19"
>
Questions related to samba's operation in and of Windows 2000/NT domains.
</section>

<section
	number="8"
	id="samba2_0_x"
	title="Samba 2.0.x"
	lang="en"
	rev="0"
	date="2000-10-19"
>
This sections cover questions related to Samba 2.0.x
</section>

<section
	number="9"
	id="samba_2_2"
	title="Samba 2.2"
	lang="en"
	rev="0"
	date="2000-10-19"
>
This sections cover questions related to Samba 2.2 which is currently in apha release.
</section>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: how-to-submit.xml
Type: text/xml
Size: 448 bytes
Desc: not available
Url : http://lists.samba.org/archive/samba-ntdom/attachments/20001019/66ff141a/how-to-submit.xml