Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Content-Type: text/plain; charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\))
Subject: Re: New contributor need help
From: Jan Lehnardt <jan@apache.org>
In-Reply-To: <CADdZc95H_aPr9PNa1K0XiDXF_--u1zqD_6-6gGA9cqKKctoN6w@mail.gmail.com>
Date: Mon, 18 Jul 2016 12:34:35 +0200
Content-Transfer-Encoding: quoted-printable
Message-Id: <A2EE51A9-FAF5-46CB-B968-8C939DA07D86@apache.org>
References: <CAFnF2+BYAuqVORiHX+DAepyngTaUgPzqw5=PPKCpO8xZAzki0g@mail.gmail.com> <CADdZc95Er9uDDOy83ucG__qQ2w=hXD+DPGte8WE=amC9RB5UCg@mail.gmail.com> <484C98C0-1574-4065-AE26-6E837347AD80@apache.org> <CADdZc96p6UTQ-dyznnvGJmj=cUPLGa0R2-6ehh2CzqqpHrsVLg@mail.gmail.com> <DC5392A5-59BD-4F19-A4CA-EBF34508248F@apache.org> <CADdZc95H_aPr9PNa1K0XiDXF_--u1zqD_6-6gGA9cqKKctoN6w@mail.gmail.com>
To: dev@couchdb.apache.org
archived-at: Mon, 18 Jul 2016 10:34:43 -0000


> On 18 Jul 2016, at 12:21, Harald Kisch <haraldkisch@gmail.com> wrote:
>=20
>>> then I=E2=80=99m confused as to why you thought this was a good =
first-contributor
> issue?
>=20
> Because I know there are some issues, and if there would be some help, =
I
> would also go hands-on, too.
> This is your chance to have two developers staffed on, fixing the
> javascript issues.

I get that part, but that=E2=80=99s not how first-contributor issues =
work, they need clear 1. 2. 3. instructions, not some handwaving at a =
problem area ;)

We=E2=80=99ve got a lot to do in this area, but I=E2=80=99ve personally =
been putting it off in favour of getting 2.0 out, which is still a bit =
of work.

We=E2=80=99ve been doing some good work on the Hoodie project that I=E2=80=
=99d like to bring over after we=E2=80=99ve shipped 2.0 to increase =
contributions. We=E2=80=99ve written up some of our findings and =
procedures here: http://hood.ie/blog/starter-issues.html (it works =
exceptionally well, that=E2=80=99s why I want to bring these over).

If anyone wants to get started on this, feel free :)

Best
Jan
--


>=20
> Best,
> Harald
>=20
> On Mon, Jul 18, 2016 at 12:02 PM, Jan Lehnardt <jan@apache.org> wrote:
>=20
>> Hi Harald,
>>=20
>>=20
>>> On 18 Jul 2016, at 11:51, Harald Kisch <haraldkisch@gmail.com> =
wrote:
>>>=20
>>> Hi Jan,
>>>=20
>>> as far as I know, the JavaScript tests have been available to verify =
if
>> the
>>> http-api is working correctly after the installation of CouchDB. =
Since
>>> version 1.6.1 there is only a verify install CTA in
>>> http://localhost:5984/_utils available which does'nt execute the =
tests
>>> explicitly. If I look into the JavaScript Test Folders I can find =
any of
>>> the tests which are testing similar http-api stuff which i did also
>> expect
>>> on localhost:5984/_utils.
>>>=20
>>> There is no README in the JavaScript folder.
>>>=20
>>> I would expect a Node.js API with Mocha, Sinon, Chai, Karma,.. Setup =
in
>>> place for the JavaScript tests, but no Node.js is used for =
javascript
>>> tests, instead there is a makefile, ruby, python setup which seems =
that I
>>> need to execute the make procedures first. The configure script =
gives me
>>> only one line, no response if it is finished or not. Make install is
>>> missing completely instead I get the response to copy recursively
>>> rel/couchdb to my /usr/local/lib folder? So nothing to make? All
>>> executables are already in place? I thought that I have the source =
codes.
>>> Very confusing and a little frustrating. I questioning me if I =
really
>> have
>>> the source code to build CouchDB from source. If I want to start =
coding
>> on
>>> the CouchDB REST-API or want to test a new http-handler based on =
erlang
>>> plugin I would like to build the sources first so that I can execute =
the
>>> tests for my current build at the couchdb.uri on =
http://127.0.0.1:15984/
>>> but it seems to be no advice how to do so.
>>>=20
>>> I see that the makefile has a javascript section which can be =
executed
>> with
>>> 'make javascript', but it confuses me to see, that the tests are =
copied
>> in
>>> the fauxton directory at 'src/fauxton/dist/release/test' and then I =
am
>> lost
>>> because I do not want to use fauxton.
>>> I also see that the tests are executed by the python script run =
with:
>>> run -n 1 -q --with-admin-party-please test/javascript/run $(suites)
>>>=20
>>> I am only a JavaScript Frontend Developer (Angular, React, Node, =
etc.)
>> with
>>> some experience in C and C++ many years ago. I would also appreciate =
to
>>> have some guidelines how to work with this kind of javascript test
>>> environment based on python, ruby and erlang.
>>=20
>> then I=E2=80=99m confused as to why you thought this was a good =
first-contributor
>> issue?
>>=20
>> Best
>> Jan
>> --
>>=20
>>>=20
>>> Kind Regards
>>>=20
>>> Harald
>>>=20
>>>=20
>>> On Mon, Jul 18, 2016 at 10:31 AM, Jan Lehnardt <jan@apache.org> =
wrote:
>>>=20
>>>> Heya Harald,
>>>>=20
>>>> could you do a quick write up on how to run the tests? Not sure =
this
>> would
>>>> be useful without, for a new contributor.
>>>>=20
>>>> Also, please use the latest build from
>>>> http://couchdb.apache.org/release-candidate/2.0/ or git master,
>> thanks! :)
>>>>=20
>>>> Best
>>>> Jan
>>>> --
>>>>=20
>>>>=20
>>>>=20
>>>>> On 18 Jul 2016, at 08:02, Harald Kisch <haraldkisch@gmail.com> =
wrote:
>>>>>=20
>>>>> Hi Huyssen,
>>>>>=20
>>>>> there are some Issues with the JavaScript Tests in the Source Code =
at
>>>>>=20
>>>>=20
>> =
https://home.apache.org/~jan/couchdb/2.0/RC/apache-couchdb-2.0.0-92c95de.t=
ar.gz
>>>>> You can try to fix them.
>>>>>=20
>>>>> Kind Regards
>>>>> Harald
>>>>>=20
>>>>> On Sun, Jul 17, 2016 at 7:36 AM, Zhang Huyssen =
<huyssen.zxp@gmail.com>
>>>>> wrote:
>>>>>=20
>>>>>> Hey there, I'm new to this community and want to get involved =
into
>>>> couchdb.
>>>>>> Where should I start and what should do next? I have some =
knowlede
>>>> about js
>>>>>> and Java, please give me some information about the issue I could =
work
>>>>>> with! Thank you very much!
>>>>>>=20
>>>>>> Best Regards,
>>>>>> Huyssen
>>>>>>=20
>>>>>=20
>>>>>=20
>>>>>=20
>>>>> --
>>>>> --
>>>>>=20
>>>>> Dipl.-Inf. Harald R. Kisch
>>>>>=20
>>>>> Falkenstra=C3=9Fe 19C
>>>>> 81541 M=C3=BCnchen
>>>>> Germany
>>>>>=20
>>>>> Mobil DE: +49 (0) 176 56 58 58 38
>>>>>=20
>>>>> Skype: harald.kisch
>>>>> Mail: haraldkisch@gmail.com
>>>>=20
>>>> --
>>>> Professional Support for Apache CouchDB:
>>>> https://neighbourhood.ie/couchdb-support/
>>>>=20
>>>>=20
>>>=20
>>>=20
>>> --
>>> --
>>>=20
>>> Dipl.-Inf. Harald R. Kisch
>>>=20
>>> Falkenstra=C3=9Fe 19C
>>> 81541 M=C3=BCnchen
>>> Germany
>>>=20
>>> Mobil DE: +49 (0) 176 56 58 58 38
>>>=20
>>> Skype: harald.kisch
>>> Mail: haraldkisch@gmail.com
>>=20
>> --
>> Professional Support for Apache CouchDB:
>> https://neighbourhood.ie/couchdb-support/
>>=20
>>=20
>=20
>=20
> --=20
> --=20
>=20
> Dipl.-Inf. Harald R. Kisch
>=20
> Falkenstra=C3=9Fe 19C
> 81541 M=C3=BCnchen
> Germany
>=20
> Mobil DE: +49 (0) 176 56 58 58 38
>=20
> Skype: harald.kisch
> Mail: haraldkisch@gmail.com

--=20
Professional Support for Apache CouchDB:
https://neighbourhood.ie/couchdb-support/