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