couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Tim McNamara <paperl...@timmcnamara.co.nz>
Subject Re: New contributor need help
Date Mon, 18 Jul 2016 15:42:08 GMT
Hijacking this thread, sorry.

Just wanted to say thank you Jan for such an excellent email. I have been
lurking on dev@ for years and have always been pretty intimidated. This has
finally got me to peek through the source again.

Thanks for such a wonderful attitude!

On 18 Jul 2016 10:17 p.m., "Jan Lehnardt" <jan@apache.org> wrote:

> Heya Huyssen,
>
> sorry for being a little obtuse here, but you’ve stumbled on one of the
> shortcomings of the CouchDB project: it is not easy to get new contributors
> started.
>
> We are aware of this and we plan to work on this soon-ish, but that won’t
> help you now ;)
>
> That said:
>
> CouchDB generally can be separated in three components:
>
> - The Erlang Core (https://github.com/apache/couchdb)
>
> - The JavaScript Test Suite (
> https://github.com/apache/couchdb/tree/master/test/javascript)
>
> - The Fauxton Web UI (HTML/CSS/JS:
> https://github.com/apache/couchdb-fauxton)
>
> And there are a few sub-projects:
>
> - couchdb-nano (a Node.js client): https://github.com/apache/couchdb-nano
> - couchdb-docker (Docker images): https://github.com/klaemo/docker-couchdb
>
> The Erlang Core requires knowledge in Erlang. If you are up for learning
> Erlang, I’d recommend to get started with
> http://learnyousomeerlang.com/content — it’s a great read and a fun
> language to learn.
>
> The JavaScript Test Suite requires knowledge in (drumroll): JavaScript,
> and a bit of how it is set up:
>
> In CouchDB master you can run it like this:
> (See INTSALL.Unix.md and README-DEV.rst to get started)
>
> ./configure -c --disable-fauxton --disable-docs
> make
> make javascript
>
> And you can run individual tests like this:
>
> ./configure -c --disable-fauxton --disable-docs
> make
> ./dev/run -n 1 --with-admin-party-please
>
> # new terminal window
> ./test/javascript/run testname
>
> The tests live in test/javascript/tests/*.js
>
> When you run `make javascript`, you might see some errors (ignore the
> attachment one), and tests marked with TODO, these would be worth diving
> into.
>
> For Fauxton, please see the README at:
> https://github.com/apache/couchdb-fauxton
>
> * * *
>
> In addition, there are a number of issues on our bug tracker that we’ve
> marked as beginner friendly:
> https://issues.apache.org/jira/browse/COUCHDB-1098?jql=project%20%3D%20COUCHDB%20AND%20status%20%3D%20Open%20AND%20cf%5B12310270%5D%20%3D%20%22New%20Contributors%20Level%20(Easy)%22%20ORDER%20BY%20priority%20DESC
> (I hope this link works)
>
> In addition addition, there are many tickets with issue reports that have
> no comments on them yet. One useful thing to do would be to check if you
> can reproduce the issue, and work on a way to show how this can be
> reproduced.
>
> Hope this helps!
>
> Best
> Jan
> --
>
>
> > On 18 Jul 2016, at 11:55, Zhang Huyssen <huyssen.zxp@gmail.com> wrote:
> >
> > Hi Harald,
> >
> > Thank you for your help. However, Where could I check those issues? Where
> > are the detail description? Please give me some more information about
> > them. Thanks a lot!
> >
> > Best,
> > Huyssen
> >
> > 2016-07-18 16:31 GMT+08:00 Jan Lehnardt <jan@apache.org>:
> >
> >> Heya Harald,
> >>
> >> could you do a quick write up on how to run the tests? Not sure this
> would
> >> be useful without, for a new contributor.
> >>
> >> Also, please use the latest build from
> >> http://couchdb.apache.org/release-candidate/2.0/ or git master,
> thanks! :)
> >>
> >> Best
> >> Jan
> >> --
> >>
> >>
> >>
> >>> On 18 Jul 2016, at 08:02, Harald Kisch <haraldkisch@gmail.com> wrote:
> >>>
> >>> Hi Huyssen,
> >>>
> >>> there are some Issues with the JavaScript Tests in the Source Code at
> >>>
> >>
> https://home.apache.org/~jan/couchdb/2.0/RC/apache-couchdb-2.0.0-92c95de.tar.gz
> >>> You can try to fix them.
> >>>
> >>> Kind Regards
> >>> Harald
> >>>
> >>> On Sun, Jul 17, 2016 at 7:36 AM, Zhang Huyssen <huyssen.zxp@gmail.com>
> >>> wrote:
> >>>
> >>>> 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!
> >>>>
> >>>> Best Regards,
> >>>> Huyssen
> >>>>
> >>>
> >>>
> >>>
> >>> --
> >>> --
> >>>
> >>> Dipl.-Inf. Harald R. Kisch
> >>>
> >>> Falkenstraße 19C
> >>> 81541 München
> >>> Germany
> >>>
> >>> Mobil DE: +49 (0) 176 56 58 58 38
> >>>
> >>> Skype: harald.kisch
> >>> Mail: haraldkisch@gmail.com
> >>
> >> --
> >> Professional Support for Apache CouchDB:
> >> https://neighbourhood.ie/couchdb-support/
> >>
> >>
>
> --
> Professional Support for Apache CouchDB:
> https://neighbourhood.ie/couchdb-support/
>
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message