From mboxrd@z Thu Jan  1 00:00:00 1970
From: "R. W. Rodolico" <rodo@dailydata.net>
To: documentation@lists.ipfire.org
Subject: Need some reviews, please
Date: Tue, 13 Sep 2016 00:24:31 -0500
Message-ID: <57D78D8F.7090109@dailydata.net>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============7033418164511183114=="
List-Id: <documentation.lists.ipfire.org>

--===============7033418164511183114==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

When I first decided to pay back some of the benefit I received from
this project, I realized I do not have the dedication or time to be a
developer. So, I test and document.

When I first started doing any documentation, I was scared to change
anything, and I believe I caused the development team more trouble
fixing my messups than I actually helped. Because of this, I started
looking more closely at the "how do we document the project" idea.

I reorganized http://wiki.ipfire.org/projects/docs/start slightly to put
articles about "How to write articles" in the bottom section, "Wiki
guideline".

At Mr. Tremer's suggestion, I then read (kind of), an original document
at http://wiki.ipfire.org/test. It is in German!

NOTE: I do not speak German. I speak three languages; English, Bad
English and Very, Very Bad Spanish. You'll note that German is not
listed there at all. Learning to count to 29 on my grandmothers knee
does not count as speaking German. Nor does 6 weeks of German class in
college. This was all about Google Translate and guessing. That article
(in Bad English) is at
http://wiki.ipfire.org/projects/docs/quick_syntax_overview and
desperately needs review.

Finally, I decided we needed some quick guidelines, so I wrote
http://wiki.ipfire.org/projects/docs/basic_documentation_guidelines.
Again, this definitely is not a finished project, and it is mainly
filled with guesses at what our basic guidelines should be. I did try to
read some of the other articles to see what these guidelines should be,
but feel free to tell me I'm way off base.

Feedback??? Please! I have very thick skin, so tons of negative feedback
will not hurt my feelings. I just want someplace we can send new
documenters to and say "here, read this if you want to know how we do
things."

Rod
-- 
Rod Rodolico
Daily Data, Inc.
POB 140465
Dallas TX 75214-0465
214.827.2170
http://www.dailydata.net

--===============7033418164511183114==--