Skip to content

Commit

Permalink
build based on 14f22e9
Browse files Browse the repository at this point in the history
Documenter.jl committed Oct 24, 2024
1 parent f90262b commit 8215eef
Showing 5 changed files with 11 additions and 11 deletions.
2 changes: 1 addition & 1 deletion dev/.documenter-siteinfo.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"documenter":{"julia_version":"1.11.1","generation_timestamp":"2024-10-24T07:54:43","documenter_version":"1.7.0"}}
{"documenter":{"julia_version":"1.11.1","generation_timestamp":"2024-10-24T07:59:37","documenter_version":"1.7.0"}}
2 changes: 1 addition & 1 deletion dev/90-contributing/index.html
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Contributing guidelines · TulipaClustering.jl</title><meta name="title" content="Contributing guidelines · TulipaClustering.jl"/><meta property="og:title" content="Contributing guidelines · TulipaClustering.jl"/><meta property="twitter:title" content="Contributing guidelines · TulipaClustering.jl"/><meta name="description" content="Documentation for TulipaClustering.jl."/><meta property="og:description" content="Documentation for TulipaClustering.jl."/><meta property="twitter:description" content="Documentation for TulipaClustering.jl."/><meta property="og:url" content="https://TulipaEnergy.github.io/TulipaClustering.jl/90-contributing/"/><meta property="twitter:url" content="https://TulipaEnergy.github.io/TulipaClustering.jl/90-contributing/"/><link rel="canonical" href="https://TulipaEnergy.github.io/TulipaClustering.jl/90-contributing/"/><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/catppuccin-mocha.css" data-theme-name="catppuccin-mocha"/><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/catppuccin-macchiato.css" data-theme-name="catppuccin-macchiato"/><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/catppuccin-frappe.css" data-theme-name="catppuccin-frappe"/><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/catppuccin-latte.css" data-theme-name="catppuccin-latte"/><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></head><body><div id="documenter"><nav class="docs-sidebar"><div class="docs-package-name"><span class="docs-autofit"><a href="../">TulipaClustering.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="../">TulipaClustering</a></li><li class="is-active"><a class="tocitem" href>Contributing guidelines</a><ul class="internal"><li><a class="tocitem" href="#Bug-reports-and-discussions"><span>Bug reports and discussions</span></a></li><li><a class="tocitem" href="#Working-on-an-issue"><span>Working on an issue</span></a></li></ul></li><li><a class="tocitem" href="../91-developer/">Developer documentation</a></li><li><a class="tocitem" href="../95-reference/">Reference</a></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>Contributing guidelines</a></li></ul><ul class="is-hidden-tablet"><li class="is-active"><a href>Contributing guidelines</a></li></ul></nav><div class="docs-right"><a class="docs-navbar-link" href="https://github.com/TulipaEnergy/TulipaClustering.jl/blob/main/docs/src/90-contributing.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="contributing"><a class="docs-heading-anchor" href="#contributing">Contributing guidelines</a><a id="contributing-1"></a><a class="docs-heading-anchor-permalink" href="#contributing" title="Permalink"></a></h1><p>First of all, thanks for the interest!</p><p>We welcome all kinds of contribution, including, but not limited to code, documentation, examples, configuration, issue creating, etc.</p><p>Be polite and respectful, and follow the code of conduct.</p><h2 id="Bug-reports-and-discussions"><a class="docs-heading-anchor" href="#Bug-reports-and-discussions">Bug reports and discussions</a><a id="Bug-reports-and-discussions-1"></a><a class="docs-heading-anchor-permalink" href="#Bug-reports-and-discussions" title="Permalink"></a></h2><p>If you think you found a bug, feel free to open an <a href="https://github.com/TulipaEnergy/TulipaClustering.jl/issues">issue</a>. Focused suggestions and requests can also be opened as issues. Before opening a pull request, start an issue or a discussion on the topic, please.</p><h2 id="Working-on-an-issue"><a class="docs-heading-anchor" href="#Working-on-an-issue">Working on an issue</a><a id="Working-on-an-issue-1"></a><a class="docs-heading-anchor-permalink" href="#Working-on-an-issue" title="Permalink"></a></h2><p>If you found an issue that interests you, comment on that issue what your plans are. If the solution to the issue is clear, you can immediately create a pull request (see below). Otherwise, say what your proposed solution is and wait for a discussion around it.</p><div class="admonition is-success"><header class="admonition-header">Tip</header><div class="admonition-body"><p>Feel free to ping us after a few days if there are no responses.</p></div></div><p>If your solution involves code (or something that requires running the package locally), check the <a href="../91-developer/">developer documentation</a>. Otherwise, you can use the GitHub interface directly to create your pull request.</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../">« TulipaClustering</a><a class="docs-footer-nextpage" href="../91-developer/">Developer documentation »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.7.0 on <span class="colophon-date" title="Thursday 24 October 2024 07:54">Thursday 24 October 2024</span>. Using Julia version 1.11.1.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Contributing guidelines · TulipaClustering.jl</title><meta name="title" content="Contributing guidelines · TulipaClustering.jl"/><meta property="og:title" content="Contributing guidelines · TulipaClustering.jl"/><meta property="twitter:title" content="Contributing guidelines · TulipaClustering.jl"/><meta name="description" content="Documentation for TulipaClustering.jl."/><meta property="og:description" content="Documentation for TulipaClustering.jl."/><meta property="twitter:description" content="Documentation for TulipaClustering.jl."/><meta property="og:url" content="https://TulipaEnergy.github.io/TulipaClustering.jl/90-contributing/"/><meta property="twitter:url" content="https://TulipaEnergy.github.io/TulipaClustering.jl/90-contributing/"/><link rel="canonical" href="https://TulipaEnergy.github.io/TulipaClustering.jl/90-contributing/"/><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/catppuccin-mocha.css" data-theme-name="catppuccin-mocha"/><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/catppuccin-macchiato.css" data-theme-name="catppuccin-macchiato"/><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/catppuccin-frappe.css" data-theme-name="catppuccin-frappe"/><link class="docs-theme-link" rel="stylesheet" type="text/css" href="../assets/themes/catppuccin-latte.css" data-theme-name="catppuccin-latte"/><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></head><body><div id="documenter"><nav class="docs-sidebar"><div class="docs-package-name"><span class="docs-autofit"><a href="../">TulipaClustering.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="../">TulipaClustering</a></li><li class="is-active"><a class="tocitem" href>Contributing guidelines</a><ul class="internal"><li><a class="tocitem" href="#Bug-reports-and-discussions"><span>Bug reports and discussions</span></a></li><li><a class="tocitem" href="#Working-on-an-issue"><span>Working on an issue</span></a></li></ul></li><li><a class="tocitem" href="../91-developer/">Developer documentation</a></li><li><a class="tocitem" href="../95-reference/">Reference</a></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>Contributing guidelines</a></li></ul><ul class="is-hidden-tablet"><li class="is-active"><a href>Contributing guidelines</a></li></ul></nav><div class="docs-right"><a class="docs-navbar-link" href="https://github.com/TulipaEnergy/TulipaClustering.jl/blob/main/docs/src/90-contributing.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="contributing"><a class="docs-heading-anchor" href="#contributing">Contributing guidelines</a><a id="contributing-1"></a><a class="docs-heading-anchor-permalink" href="#contributing" title="Permalink"></a></h1><p>First of all, thanks for the interest!</p><p>We welcome all kinds of contribution, including, but not limited to code, documentation, examples, configuration, issue creating, etc.</p><p>Be polite and respectful, and follow the code of conduct.</p><h2 id="Bug-reports-and-discussions"><a class="docs-heading-anchor" href="#Bug-reports-and-discussions">Bug reports and discussions</a><a id="Bug-reports-and-discussions-1"></a><a class="docs-heading-anchor-permalink" href="#Bug-reports-and-discussions" title="Permalink"></a></h2><p>If you think you found a bug, feel free to open an <a href="https://github.com/TulipaEnergy/TulipaClustering.jl/issues">issue</a>. Focused suggestions and requests can also be opened as issues. Before opening a pull request, start an issue or a discussion on the topic, please.</p><h2 id="Working-on-an-issue"><a class="docs-heading-anchor" href="#Working-on-an-issue">Working on an issue</a><a id="Working-on-an-issue-1"></a><a class="docs-heading-anchor-permalink" href="#Working-on-an-issue" title="Permalink"></a></h2><p>If you found an issue that interests you, comment on that issue what your plans are. If the solution to the issue is clear, you can immediately create a pull request (see below). Otherwise, say what your proposed solution is and wait for a discussion around it.</p><div class="admonition is-success"><header class="admonition-header">Tip</header><div class="admonition-body"><p>Feel free to ping us after a few days if there are no responses.</p></div></div><p>If your solution involves code (or something that requires running the package locally), check the <a href="../91-developer/">developer documentation</a>. Otherwise, you can use the GitHub interface directly to create your pull request.</p></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../">« TulipaClustering</a><a class="docs-footer-nextpage" href="../91-developer/">Developer documentation »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.7.0 on <span class="colophon-date" title="Thursday 24 October 2024 07:59">Thursday 24 October 2024</span>. Using Julia version 1.11.1.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
2 changes: 1 addition & 1 deletion dev/91-developer/index.html
Original file line number Diff line number Diff line change
@@ -7,4 +7,4 @@
pkg&gt; test</code></pre><h2 id="Working-on-a-new-issue"><a class="docs-heading-anchor" href="#Working-on-a-new-issue">Working on a new issue</a><a id="Working-on-a-new-issue-1"></a><a class="docs-heading-anchor-permalink" href="#Working-on-a-new-issue" title="Permalink"></a></h2><p>We try to keep a linear history in this repo, so it is important to keep your branches up-to-date.</p><ol><li><p>Fetch from the remote and fast-forward your local main</p><pre><code class="language-bash hljs">git fetch upstream
git switch main
git merge --ff-only upstream/main</code></pre></li><li><p>Branch from <code>main</code> to address the issue (see below for naming)</p><pre><code class="language-bash hljs">git switch -c 42-add-answer-universe</code></pre></li><li><p>Push the new local branch to your personal remote repository</p><pre><code class="language-bash hljs">git push -u origin 42-add-answer-universe</code></pre></li><li><p>Create a pull request to merge your remote branch into the org main.</p></li></ol><h3 id="Branch-naming"><a class="docs-heading-anchor" href="#Branch-naming">Branch naming</a><a id="Branch-naming-1"></a><a class="docs-heading-anchor-permalink" href="#Branch-naming" title="Permalink"></a></h3><ul><li>If there is an associated issue, add the issue number.</li><li>If there is no associated issue, <strong>and the changes are small</strong>, add a prefix such as &quot;typo&quot;, &quot;hotfix&quot;, &quot;small-refactor&quot;, according to the type of update.</li><li>If the changes are not small and there is no associated issue, then create the issue first, so we can properly discuss the changes.</li><li>Use dash separated imperative wording related to the issue (e.g., <code>14-add-tests</code>, <code>15-fix-model</code>, <code>16-remove-obsolete-files</code>).</li></ul><h3 id="Commit-message"><a class="docs-heading-anchor" href="#Commit-message">Commit message</a><a id="Commit-message-1"></a><a class="docs-heading-anchor-permalink" href="#Commit-message" title="Permalink"></a></h3><ul><li>Use imperative or present tense, for instance: <em>Add feature</em> or <em>Fix bug</em>.</li><li>Have informative titles.</li><li>When necessary, add a body with details.</li><li>If there are breaking changes, add the information to the commit message.</li></ul><h3 id="Before-creating-a-pull-request"><a class="docs-heading-anchor" href="#Before-creating-a-pull-request">Before creating a pull request</a><a id="Before-creating-a-pull-request-1"></a><a class="docs-heading-anchor-permalink" href="#Before-creating-a-pull-request" title="Permalink"></a></h3><div class="admonition is-success"><header class="admonition-header">Atomic git commits</header><div class="admonition-body"><p>Try to create &quot;atomic git commits&quot; (recommended reading: <a href="https://blog.esciencecenter.nl/the-utopic-git-history-d44b81c09593">The Utopic Git History</a>).</p></div></div><ul><li><p>Make sure the tests pass.</p></li><li><p>Make sure the pre-commit tests pass.</p></li><li><p>Fetch any <code>main</code> updates from upstream and rebase your branch, if necessary:</p><pre><code class="language-bash hljs">git fetch upstream
git rebase upstream/main BRANCH_NAME</code></pre></li><li><p>Then you can open a pull request and work with the reviewer to address any issues.</p></li></ul><h2 id="Building-and-viewing-the-documentation-locally"><a class="docs-heading-anchor" href="#Building-and-viewing-the-documentation-locally">Building and viewing the documentation locally</a><a id="Building-and-viewing-the-documentation-locally-1"></a><a class="docs-heading-anchor-permalink" href="#Building-and-viewing-the-documentation-locally" title="Permalink"></a></h2><p>Following the latest suggestions, we recommend using <code>LiveServer</code> to build the documentation. Here is how you do it:</p><ol><li>Run <code>julia --project=docs</code> to open Julia in the environment of the docs.</li><li>If this is the first time building the docs<ol><li>Press <code>]</code> to enter <code>pkg</code> mode</li><li>Run <code>pkg&gt; dev .</code> to use the development version of your package</li><li>Press backspace to leave <code>pkg</code> mode</li></ol></li><li>Run <code>julia&gt; using LiveServer</code></li><li>Run <code>julia&gt; servedocs()</code></li></ol><h2 id="Making-a-new-release"><a class="docs-heading-anchor" href="#Making-a-new-release">Making a new release</a><a id="Making-a-new-release-1"></a><a class="docs-heading-anchor-permalink" href="#Making-a-new-release" title="Permalink"></a></h2><p>To create a new release, you can follow these simple steps:</p><ul><li>Create a branch <code>release-x.y.z</code></li><li>Update <code>version</code> in <code>Project.toml</code></li><li>Update the <code>CHANGELOG.md</code>:<ul><li>Rename the section &quot;Unreleased&quot; to &quot;[x.y.z] - yyyy-mm-dd&quot; (i.e., version under brackets, dash, and date in ISO format)</li><li>Add a new section on top of it named &quot;Unreleased&quot;</li><li>Add a new link in the bottom for version &quot;x.y.z&quot;</li><li>Change the &quot;[unreleased]&quot; link to use the latest version - end of line, <code>vx.y.z ... HEAD</code>.</li></ul></li><li>Create a commit &quot;Release vx.y.z&quot;, push, create a PR, wait for it to pass, merge the PR.</li><li>Go back to main screen and click on the latest commit (link: <a href="https://github.com/TulipaEnergy/TulipaClustering.jl/commit/main">https://github.com/TulipaEnergy/TulipaClustering.jl/commit/main</a>)</li><li>At the bottom, write <code>@JuliaRegistrator register</code></li></ul><p>After that, you only need to wait and verify:</p><ul><li>Wait for the bot to comment (should take &lt; 1m) with a link to a RP to the registry</li><li>Follow the link and wait for a comment on the auto-merge</li><li>The comment should said all is well and auto-merge should occur shortly</li><li>After the merge happens, TagBot will trigger and create a new GitHub tag. Check on <a href="https://github.com/TulipaEnergy/TulipaClustering.jl/releases">https://github.com/TulipaEnergy/TulipaClustering.jl/releases</a></li><li>After the release is create, a &quot;docs&quot; GitHub action will start for the tag.</li><li>After it passes, a deploy action will run.</li><li>After that runs, the <a href="https://TulipaEnergy.github.io/TulipaClustering.jl/stable">stable docs</a> should be updated. Check them and look for the version number.</li></ul></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../90-contributing/">« Contributing guidelines</a><a class="docs-footer-nextpage" href="../95-reference/">Reference »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.7.0 on <span class="colophon-date" title="Thursday 24 October 2024 07:54">Thursday 24 October 2024</span>. Using Julia version 1.11.1.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
git rebase upstream/main BRANCH_NAME</code></pre></li><li><p>Then you can open a pull request and work with the reviewer to address any issues.</p></li></ul><h2 id="Building-and-viewing-the-documentation-locally"><a class="docs-heading-anchor" href="#Building-and-viewing-the-documentation-locally">Building and viewing the documentation locally</a><a id="Building-and-viewing-the-documentation-locally-1"></a><a class="docs-heading-anchor-permalink" href="#Building-and-viewing-the-documentation-locally" title="Permalink"></a></h2><p>Following the latest suggestions, we recommend using <code>LiveServer</code> to build the documentation. Here is how you do it:</p><ol><li>Run <code>julia --project=docs</code> to open Julia in the environment of the docs.</li><li>If this is the first time building the docs<ol><li>Press <code>]</code> to enter <code>pkg</code> mode</li><li>Run <code>pkg&gt; dev .</code> to use the development version of your package</li><li>Press backspace to leave <code>pkg</code> mode</li></ol></li><li>Run <code>julia&gt; using LiveServer</code></li><li>Run <code>julia&gt; servedocs()</code></li></ol><h2 id="Making-a-new-release"><a class="docs-heading-anchor" href="#Making-a-new-release">Making a new release</a><a id="Making-a-new-release-1"></a><a class="docs-heading-anchor-permalink" href="#Making-a-new-release" title="Permalink"></a></h2><p>To create a new release, you can follow these simple steps:</p><ul><li>Create a branch <code>release-x.y.z</code></li><li>Update <code>version</code> in <code>Project.toml</code></li><li>Update the <code>CHANGELOG.md</code>:<ul><li>Rename the section &quot;Unreleased&quot; to &quot;[x.y.z] - yyyy-mm-dd&quot; (i.e., version under brackets, dash, and date in ISO format)</li><li>Add a new section on top of it named &quot;Unreleased&quot;</li><li>Add a new link in the bottom for version &quot;x.y.z&quot;</li><li>Change the &quot;[unreleased]&quot; link to use the latest version - end of line, <code>vx.y.z ... HEAD</code>.</li></ul></li><li>Create a commit &quot;Release vx.y.z&quot;, push, create a PR, wait for it to pass, merge the PR.</li><li>Go back to main screen and click on the latest commit (link: <a href="https://github.com/TulipaEnergy/TulipaClustering.jl/commit/main">https://github.com/TulipaEnergy/TulipaClustering.jl/commit/main</a>)</li><li>At the bottom, write <code>@JuliaRegistrator register</code></li></ul><p>After that, you only need to wait and verify:</p><ul><li>Wait for the bot to comment (should take &lt; 1m) with a link to a RP to the registry</li><li>Follow the link and wait for a comment on the auto-merge</li><li>The comment should said all is well and auto-merge should occur shortly</li><li>After the merge happens, TagBot will trigger and create a new GitHub tag. Check on <a href="https://github.com/TulipaEnergy/TulipaClustering.jl/releases">https://github.com/TulipaEnergy/TulipaClustering.jl/releases</a></li><li>After the release is create, a &quot;docs&quot; GitHub action will start for the tag.</li><li>After it passes, a deploy action will run.</li><li>After that runs, the <a href="https://TulipaEnergy.github.io/TulipaClustering.jl/stable">stable docs</a> should be updated. Check them and look for the version number.</li></ul></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../90-contributing/">« Contributing guidelines</a><a class="docs-footer-nextpage" href="../95-reference/">Reference »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.7.0 on <span class="colophon-date" title="Thursday 24 October 2024 07:59">Thursday 24 October 2024</span>. Using Julia version 1.11.1.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
14 changes: 7 additions & 7 deletions dev/95-reference/index.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dev/index.html
Original file line number Diff line number Diff line change
@@ -17,4 +17,4 @@
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END --></article><nav class="docs-footer"><a class="docs-footer-nextpage" href="90-contributing/">Contributing guidelines »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.7.0 on <span class="colophon-date" title="Thursday 24 October 2024 07:54">Thursday 24 October 2024</span>. Using Julia version 1.11.1.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
<!-- ALL-CONTRIBUTORS-LIST:END --></article><nav class="docs-footer"><a class="docs-footer-nextpage" href="90-contributing/">Contributing guidelines »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.7.0 on <span class="colophon-date" title="Thursday 24 October 2024 07:59">Thursday 24 October 2024</span>. Using Julia version 1.11.1.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>

0 comments on commit 8215eef

Please sign in to comment.