Need some reviews, please

[Carlo Fusco <fusco.carlo@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2259 bytes --]

On Tue, Sep 13, 2016 at 7:24 AM, R. W. Rodolico <rodo(a)dailydata.net> wrote:
[cut]
>
> 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.


thank you for doing that, as a newbie I appreciate very much this work.

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


from the point of view of a newbie can I make a suggestion? Can you
incorporate in the main text what is now in the link

http://wiki.ipfire.org/en/edit

In other words, make it explicit what to do. Something along this
line, Do you want to contribute to improve the documentations? First
read these links and then open an account etc..

> 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.


I don't understand, what's wrong with this:
http://wiki.ipfire.org/wiki/syntax

which I believe is part of the standard documentation of DokuWIki. Did
you want a more synthetic document?
Regardless, I think that the links to the documentation in German
should be removed.

>
> Finally, I decided we needed some quick guidelines, so I wrote
> http://wiki.ipfire.org/projects/docs/basic_documentation_guidelines.


That's very, very nice. Thank you for doing this. As I said, as a
newbie I really appreciate this work. I didn't know about the
namespace issues you described so well, clear and to the point. I like
it.

Thanks again, including for all your help and encouragement.

-- 
Carlo Fusco



-- 
Carlo Fusco