docs/development/contributing/index.html in rbcli-0.3.0 vs docs/development/contributing/index.html in rbcli-0.3.1
- old
+ new
@@ -1,34 +1,34 @@
<!DOCTYPE html>
<html lang="en" class="js csstransforms3d">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <meta name="generator" content="Hugo 0.74.3" />
+ <meta name="generator" content="Hugo 0.88.1" />
<meta name="description" content="">
<link rel="icon" href="/rbcli/images/favicon.png" type="image/png">
<title>Contribution Guide :: RBCli Documentation</title>
- <link href="/rbcli/css/nucleus.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/fontawesome-all.min.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/hybrid.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/featherlight.min.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/perfect-scrollbar.min.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/auto-complete.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/atom-one-dark-reasonable.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/theme.css?1596148729" rel="stylesheet">
- <link href="/rbcli/css/hugo-theme.css?1596148729" rel="stylesheet">
+ <link href="/rbcli/css/nucleus.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/fontawesome-all.min.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/hybrid.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/featherlight.min.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/perfect-scrollbar.min.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/auto-complete.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/atom-one-dark-reasonable.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/theme.css?1634703589" rel="stylesheet">
+ <link href="/rbcli/css/hugo-theme.css?1634703589" rel="stylesheet">
- <link href="/rbcli/css/theme-blue.css?1596148729" rel="stylesheet">
+ <link href="/rbcli/css/theme-blue.css?1634703589" rel="stylesheet">
- <script src="/rbcli/js/jquery-3.3.1.min.js?1596148729"></script>
+ <script src="/rbcli/js/jquery-3.3.1.min.js?1634703589"></script>
<style>
:root #header + #content > #left > #rlblock_left{
display:none !important;
}
@@ -53,18 +53,18 @@
<label for="search-by"><i class="fas fa-search"></i></label>
<input data-search-input id="search-by" type="search" placeholder="Search...">
<span data-search-clear=""><i class="fas fa-times"></i></span>
</div>
-<script type="text/javascript" src="/rbcli/js/lunr.min.js?1596148729"></script>
-<script type="text/javascript" src="/rbcli/js/auto-complete.js?1596148729"></script>
+<script type="text/javascript" src="/rbcli/js/lunr.min.js?1634703589"></script>
+<script type="text/javascript" src="/rbcli/js/auto-complete.js?1634703589"></script>
<script type="text/javascript">
var baseurl = "https:\/\/akhoury6.github.io\/rbcli\/";
</script>
-<script type="text/javascript" src="/rbcli/js/search.js?1596148729"></script>
+<script type="text/javascript" src="/rbcli/js/search.js?1634703589"></script>
</div>
<div class="highlightable">
@@ -712,32 +712,32 @@
<li>Submit a pull request when ready</li>
</ol>
<p>That’s all there is to it! We’ve also kept our acceptance criteria pretty simple, as you’ll see below. Feel free to submit a pull request even if you don’t meet it if you would like your code or feature to be reviewed first; we do want to be mindful of your time and will review submissions before they are polished.</p>
<h1 id="develpment-mode">Develpment Mode</h1>
<p>To allow for easy deveopment, Rbcli has a development mode which allows a project to include rbcli from a local folder instead of the default gem path. To use it, add the following to your shell’s profile (typically <code>~/.bash_profile</code> or <code>~/.profile</code>):</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">export RBCLI_ENV<span style="color:#f92672">=</span><span style="color:#e6db74">'development'</span>
+<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">export RBCLI_ENV<span style="color:#f92672">=</span><span style="color:#e6db74">'development'</span>
export RBCLI_DEVPATH<span style="color:#f92672">=</span><span style="color:#e6db74">'/path/to/rbcli/lib/rbcli'</span>
alias rbcli<span style="color:#f92672">=</span><span style="color:#e6db74">'/path/to/rbcli/exe/rbcli'</span>
</code></pre></div><h1 id="code-acceptance-criteria">Code Acceptance Criteria</h1>
<h2 id="tabs-not-spaces">Tabs, Not Spaces</h2>
<p>Please, and thanks. We all like to use different indentation levels and styles, and this will keep us consistent between editors.</p>
<p>For filetypes where tabs are not supported (such as YAML), please stick to using two (2) spaces.</p>
<h2 id="documentation-for-user-features">Documentation for User Features</h2>
<p>For any modification that alters the way RBCli is used – we’re talking additional features, options, keyword changes, major behavioral changes, and the like – the documentation will need to be updated as well. You’ll be happy to know we designed it to make the process relatively painless.</p>
<p>RBCli’s documentation is essentially a collection of markdown files that have been compiled into a static site using <a href="https://www.mkdocs.org">MkDocs</a>. If you already have python and pip on your system, you can install it by running:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">pip install mkdocs mkdocs-material
+<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">pip install mkdocs mkdocs-material
</code></pre></div><p>You can find the source markdown files in the <code>docs-src/docs</code> folder, and the menu organization in <code>docs-src/mkdocs.yml</code>. To preview your changes on a live site, run:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">mkdocs serve
+<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">mkdocs serve
</code></pre></div><p>Also, don’t forget to update the <strong>Quick Reference Guide</strong> in the <code>README.md</code> file (the main project one) with information about your changes.</p>
<p>Once you’ve completed your edits, run the <code>makesite.sh</code> command to build the actual HTML pages automatically in the <code>docs</code> folder, from where they will be served when live.</p>
<h2 id="deprecations">Deprecations</h2>
<p>If a feature needs to be deprecated, RBCli has a built-in deprecation message feature. You can leverage it by calling the following code when a deprecated command is called:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-ruby" data-lang="ruby"><span style="color:#66d9ef">Rbcli</span><span style="color:#f92672">::</span><span style="color:#66d9ef">DeprecationWarning</span><span style="color:#f92672">.</span>new deprecated_command, message, version_when_code_will_be_removed
+<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-ruby" data-lang="ruby"><span style="color:#66d9ef">Rbcli</span><span style="color:#f92672">::</span><span style="color:#66d9ef">DeprecationWarning</span><span style="color:#f92672">.</span>new deprecated_command, message, version_when_code_will_be_removed
</code></pre></div><p>So, for example:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-ruby" data-lang="ruby"><span style="color:#66d9ef">Rbcli</span><span style="color:#f92672">::</span><span style="color:#66d9ef">DeprecationWarning</span><span style="color:#f92672">.</span>new <span style="color:#e6db74">'Rbcli::Configurate.me--first_run'</span>, <span style="color:#e6db74">'Please use `RBCli::Configurate.hooks` as the parent block instead.'</span>, <span style="color:#e6db74">'0.3.0'</span>
+<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-ruby" data-lang="ruby"><span style="color:#66d9ef">Rbcli</span><span style="color:#f92672">::</span><span style="color:#66d9ef">DeprecationWarning</span><span style="color:#f92672">.</span>new <span style="color:#e6db74">'Rbcli::Configurate.me--first_run'</span>, <span style="color:#e6db74">'Please use `RBCli::Configurate.hooks` as the parent block instead.'</span>, <span style="color:#e6db74">'0.3.0'</span>
</code></pre></div><p>will display the following message to the user, in red, any any time the application is run:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-text" data-lang="text">DEPRECATION WRNING: The feature `Rbcli::Configurate.me--post_hook` has been deprecated. Please use `RBCli::Configurate.hooks` as the parent block instead. This feature will be removed in version 0.3.0.
+<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-text" data-lang="text">DEPRECATION WRNING: The feature `Rbcli::Configurate.me--post_hook` has been deprecated. Please use `RBCli::Configurate.hooks` as the parent block instead. This feature will be removed in version 0.3.0.
</code></pre></div><p>Additionally, it will place the same line in the logs using <code>Rbcli.logger.warn</code> if logging is enabled.</p>
<p>If a deprecation warning has been added, please remember to mention it in the pull request so that others can update it later.</p>
<h1 id="maintainers-notes">Maintainer’s Notes</h1>
<p>To install this gem onto your local machine from source, run <code>bundle exec rake install</code>.</p>
<p>To release a new version, follow theese steps:</p>
@@ -1176,22 +1176,22 @@
</section>
<div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
<div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
</div>
- <script src="/rbcli/js/clipboard.min.js?1596148729"></script>
- <script src="/rbcli/js/perfect-scrollbar.min.js?1596148729"></script>
- <script src="/rbcli/js/perfect-scrollbar.jquery.min.js?1596148729"></script>
- <script src="/rbcli/js/jquery.sticky.js?1596148729"></script>
- <script src="/rbcli/js/featherlight.min.js?1596148729"></script>
- <script src="/rbcli/js/highlight.pack.js?1596148729"></script>
+ <script src="/rbcli/js/clipboard.min.js?1634703589"></script>
+ <script src="/rbcli/js/perfect-scrollbar.min.js?1634703589"></script>
+ <script src="/rbcli/js/perfect-scrollbar.jquery.min.js?1634703589"></script>
+ <script src="/rbcli/js/jquery.sticky.js?1634703589"></script>
+ <script src="/rbcli/js/featherlight.min.js?1634703589"></script>
+ <script src="/rbcli/js/highlight.pack.js?1634703589"></script>
<script>hljs.initHighlightingOnLoad();</script>
- <script src="/rbcli/js/modernizr.custom-3.6.0.js?1596148729"></script>
- <script src="/rbcli/js/learn.js?1596148729"></script>
- <script src="/rbcli/js/hugo-learn.js?1596148729"></script>
+ <script src="/rbcli/js/modernizr.custom-3.6.0.js?1634703589"></script>
+ <script src="/rbcli/js/learn.js?1634703589"></script>
+ <script src="/rbcli/js/hugo-learn.js?1634703589"></script>
- <link href="/rbcli/mermaid/mermaid.css?1596148729" rel="stylesheet" />
- <script src="/rbcli/mermaid/mermaid.js?1596148729"></script>
+ <link href="/rbcli/mermaid/mermaid.css?1634703589" rel="stylesheet" />
+ <script src="/rbcli/mermaid/mermaid.js?1634703589"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>