On Tue, Sep 13, 2016 at 7:24 AM, R. W. Rodolico 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