Am 31.10.16 um 01:59 schrieb Adam Jensen:
> Hi, I am very new to this software.
>
> NaviServer 4.99.14d1 under FreeBSD 11.0-RELEASE-p1
>
> One of the first things that I noticed was the [writer example][1]
the contrib/example pages have not been maintained since ages, ...
but you are right, a novice will reach this pages quickly and gets
a bad impression, if these examples are obviously incorrect.
> doesn't do what it says it does.
I've updated the writer.tcl and the upload.tcl examples (although the latter
has to be tested with a slower upload line).... but esp. for uploading,
there are now many more js widgets available, which do not require
backend support.
> Also, there is broken English all over the place. Is there a convenient
> process to make note of problems or is broken English just the way of
> things? (Jeez, I sound like an ass. That wasn't my intention.)
yes, the documentation should be improved at many places. I think,
we are getting gradually better, but there is still a long way to go.
many of us use naviserver since many years, so we get blind to
things, which pop up immediately to the eye of a new user.
Also keep in mind, that the code and documentation was written
by people with many mother tongues.

But contributing is easy: in case someone finds something to improve
(from wording of README files to docs and code), just clone the project
on bitbucket, improve the issues in your clone and issue a pull request.
> It was at this point in the set up process that I looked for a mailing
> list. (Really, I'm not an ass. It must have been a rough week or something.)
nobody has this impression, instead, your comments are appreciated!
> Anyway, hello.
welcome!
-g


------------------------------------------------------------------------------
The Command Line: Reinvented for Modern Developers
Did the resurgence of CLI tooling catch you by surprise?
Reconnect with the command line and become more productive. 
Learn the new .NET and ASP.NET CLI. Get your free copy!
http://sdm.link/telerik
_______________________________________________
naviserver-devel mailing list
naviserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/naviserver-devel

Reply via email to