Re: [naviserver-devel] initial set up and first look

[Gustaf N. <ne...@wu...>]

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