= Orxonox Primer = ei all! this is a little tutorial for all new to orxonox, for all other a little refresh: == 1. Maillists == we got 3 major mailing lists: [[br]] [http://datacore.ch/DCwiki.dc/Wiki.jsp?page=Mailman&InsertPagePlugin_0_callback=true&InsertPagePlugin_0_depth=0&InsertPagePlugin_0_url=https%3A%2F%2Fmail.datacore.ch%2Fmailman%2Flistinfo%2Forxonox-dev orxonox-dev at mail.datacore.ch] : development stuff just for us [[br]] [http://datacore.ch/DCwiki.dc/Wiki.jsp?page=Mailman&InsertPagePlugin_0_callback=true&InsertPagePlugin_0_depth=0&InsertPagePlugin_0_url=https%3A%2F%2Fmail.datacore.ch%2Fmailman%2Flistinfo%2Forxonox-announce orxonox-announce at mail.datacore.ch] : annonucements to all who like orx [[br]] [http://datacore.ch/DCwiki.dc/Wiki.jsp?page=Mailman&InsertPagePlugin_0_callback=true&InsertPagePlugin_0_depth=0&InsertPagePlugin_0_url=https%3A%2F%2Fmail.datacore.ch%2Fmailman%2Flistinfo%2Forxonox-commit orxonox-commit at mail.datacore.ch] : auto-mail if svn repos changes [[br]] == 2. Webpage == we've got two web pages: [[br]] [http://www.orxonox.ethz.ch The Main Page]: this page is for all that want some quick infos [[br]] [https://www.orxonox.ethz.ch/cgi-bin/trac.cgi/wiki This Wiki]: wiki for developers, to work more interactive [[br]] The wiki got some nice features like the ticket system: there you can set up development requests. the roadmap shows you what the current development goals are. Anyone with a account/pass (all developers) is able to make changes to the wiki or the ticket system, just use the account from the subversion. == 3. Repository == Orxonox is been programmed by many programmers at the same time (at the moment, we are 7 programmers). to synchronize the work and to make it available for all, we got a central subversion server (subversion is a newer form of cvs). most linux got svn (subversion) in their software repository (gentoo: portage tree, debian: apt-system) windows needs special software, that you can get from: http://tortoisesvn.tigris.org/ If you want to read more about this topic, you will find more infos in: * [http://svnbook.red-bean.com/en/1.1/index.html the official subversion guide, written very funny] * [http://www.onlamp.com/pub/a/onlamp/2002/10/31/subversion.html a shorter version] you can download the repos in linux by typing: {{{ valisk $ svn co "https://svn.orxonox.ethz.ch/reporx/orxonox" orxonox }}} == 4. Compiling and Running == to get orx running on your system, read the following articles: [wiki:Running Get it Running]. == 5. Chat, IRC == you will find us normaly on our irc-channel on: '''irc://irc.datacore.ch ''', channel: '''#orxonox'''. there we talk about orx, development issues or anything else... == 6. Mailaliases == we are maintaining a mail server. if possible, we normaly register for every user peter muster following email adresses: * peter at orxonox.ethz.ch * peter.muster at orxonox.ethz.ch * muster at orxonox.ethz.ch and forward them to your email account or to a localy mailbox on the server, that you will be able to check out via imap == 7. Webpage Stats: == we have installed a graph, that monitors the current web traffic on our server. we keep track about visits/hits on our website. you find it in: * [http://www.orxonox.ethz.ch/awstat/awstats.pl?config=www.orxonox.ethz.ch awstat on orxonox server] you will have to log in with your account (subversion/wiki) == 8. Finding your Way as a Developer == As a developer of orxonox (coder/modler) you will want to communicate over our mailinglists, the wiki and the irc. You will find the current tasks, for the next orxonox release under: * [https://www.orxonox.ethz.ch/cgi-bin/trac.cgi/roadmap Roadmap] and all tasks, that we have defined yet: * [https://www.orxonox.ethz.ch/cgi-bin/trac.cgi/report/1 Tasks] You will see the current changes on the orxonox source and the wiki on the timline of our wiki: * [https://www.orxonox.ethz.ch/cgi-bin/trac.cgi/timeline timeline] the commit messages will also be sent to your email adress, if you have registered to the orxonox-commit mailinglist == 9. Understanding Orxonox == This will definitly take some time to understand the orxonox. The best way to get your questions answered is to post them on the development-mailinglist. Even better is just to go the the developers and ask them to give you an overview... Once you know where to find which functions, you will want to read more about special topics in the sourcefiles itself: we use doxygen to comment the code, there you will find a comment to every class/function. There is a second source of information, that we are currently working on: [wiki:ModulesDescription module description]