<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>About · ControllerFormats.jl</title><meta name="title" content="About · ControllerFormats.jl"/><meta property="og:title" content="About · ControllerFormats.jl"/><meta property="twitter:title" content="About · ControllerFormats.jl"/><meta name="description" content="Documentation for ControllerFormats.jl."/><meta property="og:description" content="Documentation for ControllerFormats.jl."/><meta property="twitter:description" content="Documentation for ControllerFormats.jl."/><script data-outdated-warner src="../assets/warner.js"></script><link href="https://cdnjs.cloudflare.com/ajax/libs/lato-font/3.0.0/css/lato-font.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/juliamono/0.050/juliamono.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.2/css/fontawesome.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.2/css/solid.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.2/css/brands.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.8/katex.min.css" rel="stylesheet" type="text/css"/><script>documenterBaseURL=".."</script><script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.6/require.min.js" data-main="../assets/documenter.js"></script><script src="../search_index.js"></script><script src="../siteinfo.js"></script><script src="../../versions.js"></script><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/documenter-dark.css" data-theme-name="documenter-dark" data-theme-primary-dark/><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/documenter-light.css" data-theme-name="documenter-light" data-theme-primary/><script src="../assets/themeswap.js"></script><link href="../assets/aligned.css" rel="stylesheet" type="text/css"/></head><body><div id="documenter"><nav class="docs-sidebar"><a class="docs-logo" href="../"><img src="../assets/logo.png" alt="ControllerFormats.jl logo"/></a><div class="docs-package-name"><span class="docs-autofit"><a href="../">ControllerFormats.jl</a></span></div><button class="docs-search-query input is-rounded is-small is-clickable my-2 mx-auto py-1 px-2" id="documenter-search-query">Search docs (Ctrl + /)</button><ul class="docs-menu"><li><a class="tocitem" href="../">Home</a></li><li><span class="tocitem">Library</span><ul><li><a class="tocitem" href="../lib/ControllerFormats/">ControllerFormats module</a></li><li><a class="tocitem" href="../lib/Architecture/">Architecture module</a></li><li><a class="tocitem" href="../lib/FileFormats/">FileFormats module</a></li></ul></li><li class="is-active"><a class="tocitem" href>About</a><ul class="internal"><li><a class="tocitem" href="#Contributing"><span>Contributing</span></a></li><li><a class="tocitem" href="#Credits"><span>Credits</span></a></li></ul></li></ul><div class="docs-version-selector field has-addons"><div class="control"><span class="docs-label button is-static is-size-7">Version</span></div><div class="docs-selector control is-expanded"><div class="select is-fullwidth is-size-7"><select id="documenter-version-selector"></select></div></div></div></nav><div class="docs-main"><header class="docs-navbar"><a class="docs-sidebar-button docs-navbar-link fa-solid fa-bars is-hidden-desktop" id="documenter-sidebar-button" href="#"></a><nav class="breadcrumb"><ul class="is-hidden-mobile"><li class="is-active"><a href>About</a></li></ul><ul class="is-hidden-tablet"><li class="is-active"><a href>About</a></li></ul></nav><div class="docs-right"><a class="docs-navbar-link" href="https://github.com/JuliaReach/ControllerFormats.jl" title="View the repository on GitHub"><span class="docs-icon fa-brands"></span><span class="docs-label is-hidden-touch">GitHub</span></a><a class="docs-navbar-link" href="https://github.com/JuliaReach/ControllerFormats.jl/blob/master/docs/src/about.md" title="Edit source on GitHub"><span class="docs-icon fa-solid"></span></a><a class="docs-settings-button docs-navbar-link fa-solid fa-gear" id="documenter-settings-button" href="#" title="Settings"></a><a class="docs-article-toggle-button fa-solid fa-chevron-up" id="documenter-article-toggle-button" href="javascript:;" title="Collapse all docstrings"></a></div></header><article class="content" id="documenter-page"><h1 id="About"><a class="docs-heading-anchor" href="#About">About</a><a id="About-1"></a><a class="docs-heading-anchor-permalink" href="#About" title="Permalink"></a></h1><p>This page contains some general information about this project and recommendations about contributing.</p><h2 id="Contributing"><a class="docs-heading-anchor" href="#Contributing">Contributing</a><a id="Contributing-1"></a><a class="docs-heading-anchor-permalink" href="#Contributing" title="Permalink"></a></h2><p>If you like this package, consider contributing!</p><p><a href="https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue">Creating an issue</a> in the <a href="https://github.com/JuliaReach/ControllerFormats.jl/issues">ControllerFormats GitHub issue tracker</a> to report a bug, open a discussion about existing functionality, or suggest new functionality is appreciated.</p><p>If you have written code and would like it to be peer reviewed and added to the library, you can <a href="https://docs.github.com/en/get-started/quickstart/fork-a-repo">fork</a> the repository and send a pull request (see below).</p><p>You are also welcome to get in touch with us in the <a href="https://julialang.zulipchat.com/#narrow/stream/278609-juliareach">JuliaReach Zulip channel</a>.</p><p>Below we give some general comments about contributing to this package. The <a href="https://juliareach.github.io/JuliaReachDevDocs/latest/">JuliaReach development documentation</a> describes coding guidelines; take a look when in doubt about the coding style that is expected for the code that is finally merged into the library.</p><h3 id="Branches-and-pull-requests-(PR)"><a class="docs-heading-anchor" href="#Branches-and-pull-requests-(PR)">Branches and pull requests (PR)</a><a id="Branches-and-pull-requests-(PR)-1"></a><a class="docs-heading-anchor-permalink" href="#Branches-and-pull-requests-(PR)" title="Permalink"></a></h3><p>We use a standard pull-request policy: You work in a private branch and eventually add a pull request, which is then reviewed by other programmers and merged into the <code>master</code> branch.</p><p>Each pull request should be based on a branch with the name of the author followed by a descriptive name, e.g., <code>mforets/my_feature</code>. If the branch is associated to a previous discussion in an issue, we use the number of the issue for easier lookup, e.g., <code>mforets/7</code>.</p><h3 id="Unit-testing-and-continuous-integration-(CI)"><a class="docs-heading-anchor" href="#Unit-testing-and-continuous-integration-(CI)">Unit testing and continuous integration (CI)</a><a id="Unit-testing-and-continuous-integration-(CI)-1"></a><a class="docs-heading-anchor-permalink" href="#Unit-testing-and-continuous-integration-(CI)" title="Permalink"></a></h3><p>This project is synchronized with GitHub Actions such that each PR gets tested before merging (and the build is automatically triggered after each new commit). For the maintainability of this project, it is important to make all unit tests pass.</p><p>To run the unit tests locally, you can do:</p><pre><code class="language-julia hljs">julia> using Pkg
0 commit comments