[Olympus] NIM paper for the OLYMPUS Experiment

[Douglas Kenneth Hasell]

Dear Colleagues,

	A very rough draft for the OLYMPUS Experiment paper was sent around before=
 the collaboration meeting.  During the meeting we discussed it briefly and=
 decided that various experts should now take responsibility for receiving =
any comments or corrections on their sections and improving these sections =
appropriately.

	The experts and the sections they are responsible for are:

Douglas Hasell - Abstract, Introduction, Detector Overview, Trigger, Summary

Uwe Schneekloth - DORIS

Jan Bernauer - Target and Vacuum, Slow Control, Data Quality Monitoring (ne=
w)

Axel Schmidt - Toroid Magnet, Wire chambers

Michael Kohl - TOF, Luminosity Overview, GEM, =


Denis Veretennikov - MWPC

Roberto Perez Benito - M=F8ller

Philipp Hoffmeister - DAQ

Brian Henderson - Operation (new)

	People with any corrections, comments, suggestions, or content on any of t=
hese sections should communicate them directly to the relevant expert.

	The goal is to have reasonably good draft paper in about 1 month that can =
be distributed for further comments, and then finally discussed and approve=
d for submission at the collaboration meeting in October.

	For the experts a few guidleines:

1. We are writing everything in LaTeX.

2. The bibliography uses BibTeX with NatBib formating.

3. We are using the cleveref package.

4. Version control is with GIT.

	Just to be pedantic I repeat the instructions for obtaining the current ve=
rsion of the paper:

1. First make a directory for your local working copy:

	mkdir olympus_paper_nim

2. Change to that directory:

	cd olympus_paper_nim

3. Clone the repository from Oweb (now at Bonn) to the current directory (N=
B the "." at the end of the line is necessary)

	git clone gitolite at oweb.hiskp.uni-bonn.de:olympus_paper_nim .

4. Now you will have a working copy of all files needed for the paper.

5. To compile it using pdflatex use:

	pdflatex OLYMPUS_NIM

6. Repeat step 5 a couple of times to resolve references.

7. Resolve the bibliography references:

	bibtex OLYMPUS_NIM

8. Repeat command 5 a couple of times again to incorporate the citations.

9. There should now be a OLYMPUS_NIM.pdf file with the entire paper in the =
current version.

10. When you want to work on the paper first check for updates.

	git pull

11.  Make changes to the files as you wish.

12. If you add a new file, add it to your local repository too.

	git add filename

13. If you want to delete a file from the repository.

	git rm filename

14. Commit your edits to your local repository frequently (every hour or so=
).

	git commit -a -m "Short messge saying what you have changed."

15. Repeat steps 5 through 8.

16. Fix your mistakes and repeat steps 5 through 8 until everything works a=
nd you produce a clean PDF version with no bugs.

17. Push clean working changes to the master repository.

	git push

For this last step Jan needs to grant you access.  Everyone can pull from t=
he repository and have there own local version which they can keep up to da=
te.

                                                    Cheers,
                                                            Douglas

26-415 M.I.T.                                 Tel: +1 (617) 258-7199
77 Massachusetts Avenue                       Fax: +1 (617) 258-5440
Cambridge, MA 02139, USA                      E-mail: hasell at mit.edu       =
    =




-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 1586 bytes
Desc: not available
Url : http://mailman.mit.edu/pipermail/olympus/attachments/20130712/9ce6323=
f/attachment.bin