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" <[email protected]> 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 <[email protected]> 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 <[email protected]>: > > > >> 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 <[email protected]> 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 <[email protected]> > >>> 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: [email protected] > >> > >> -- > >> Professional Support for Apache CouchDB: > >> https://neighbourhood.ie/couchdb-support/ > >> > >> > > -- > Professional Support for Apache CouchDB: > https://neighbourhood.ie/couchdb-support/ > >
