############## Developer info ############## Github ====== The Horace code can be accessed on github where it exists as part of `PACE-Neutrons `__ project. To use Horace you also need Herbert, so you can clone Horace and Herbert from appropritate `Herbert `__ and `Horace `__ Git repositories. To get write access to Horace/Herbert you must request the permission from the repositories administrators. Alternatively, clone project from Master, make your changes to a branch and issue a pull request which will be considered by Horace team. Horace configuration on `isiscompute `__\ \|\ `iDaaaS `__ servers ============================================================================================================================================================================================================================================== The technical information on how to configure Matlab to use Horace on `isiscompute `__\ \|\ `iDaaaS `__ severs can be accessed through `this link `__ Building Horace distribution kit ================================ `Horace web distribution kit `__ is provided for users who does not have access or does not want to access Horace on `isiscompute `__\ \|\ `iDaaaS `__ servers. It is generated from a Horace code by `make_horace_deployment_kit `__ script, found within Horace `admin `__ folder. A developer, who wants to generate `Horace distribution kit `__ should run this script from Matlab session with the Horace initialized to the version, intended for distribution, and selecting Matlab current working directory located outside of the Horace code tree. Within this directory the script generates number of zip files, corresponding to various `Horace&Herbert distributions flavours `__. These files have to be then placed manually into the folder, exposed to the web through the `Horace distribution kit `__ link. Physically, the web folder is currently located on ISIS internal network at **shadow** server and exposed through *\\\\\shadow\\horacekits$* (Horace) and *\\\\\shadow\\libisiskits$* (Mslice) folders. Access to these folders as Windows shares needs developers **federal ID** and password. You may need to ask `Freddie Akeroyd `__ for write access to the web folders. `Alex Buts `__ usually updates web distribution kit each time Horace **isiscompute&&iDaaaS** version is updated. Wiki page editing protocol ========================== (N.B. For Horace web editors only) First, do NOT use the subsection *edit* links on long pages. Always use the *edit* tab at the top of the page, in order to avoid formatting problems. In order to ensure that the Horace website remains self consistent, there are several checks you need to make. - If you need to create a brand new page (use sparingly) for your entry, simply type the URL that you would like it to have into your browser's address bar. This will load a blank page, with the option *create* instead of *edit* at the top. - Generally, you should try to append your new entry to an existing page. If you create a subheading (see existing pages for code examples) then you can link to this from elsewhere. - Consider whether your new entry merits an addition to the :ref:`Example_scripts ` section. If so, make the change. Also add the change to the example scripts held on ISIScompute, to ensure consistency. - Ensure your new edit, if it describes a new routine, is correctly linked in the :ref:`List of functions ` page.