<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html lang="en" style='--code-editor-font: var(--default-mono-font, "GitLab Mono"), JetBrains Mono, Menlo, DejaVu Sans Mono, Liberation Mono, Consolas, Ubuntu Mono, Courier New, andale mono, lucida console, monospace;'>
<head>
<meta content="text/html; charset=US-ASCII" http-equiv="Content-Type">
<title>
GitLab
</title>

<style data-premailer="ignore" type="text/css">
a { color: #1068bf; }
</style>

<style>img {
max-width: 100%; height: auto;
}
body {
font-size: .875rem;
}
body {
-webkit-text-shadow: rgba(255,255,255,.01) 0 0 1px;
}
body {
font-family: "GitLab Sans",-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Noto Sans",Ubuntu,Cantarell,"Helvetica Neue",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji"; font-size: inherit;
}
</style>
</head>
<body style='font-size: inherit; -webkit-text-shadow: rgba(255,255,255,.01) 0 0 1px; font-family: "GitLab Sans",-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Noto Sans",Ubuntu,Cantarell,"Helvetica Neue",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";'>
<div class="content">

<p style="color: #777777;">
<a href="https://gitlab.rtems.org/amar">Amar Takhar</a>
<a href="https://gitlab.rtems.org/rtems/docs/rtems-docs/-/issues/100#note_120802">commented</a>:
</p>
<div class="md" style="position: relative; z-index: 1; color: #28272d; word-wrap: break-word;">
<p dir="auto" style="color: #28272d; margin: 0 0 16px;" align="initial">We should use the only directive from Sphinx in order to make the text conditional.  We can have an admonish and point them to the downloads page <a href="https://www.rtems.org/download/" rel="nofollow noreferrer noopener" target="_blank" style="margin-top: 0;">https://www.rtems.org/download/</a> if they are looking for the release and then build the docs for a release.</p>
<p dir="auto" style="color: #28272d; margin: 0 0 16px;" align="initial">This can be done with tags:</p>
<ul dir="auto" style="text-align: initial; list-style-type: disc; margin: 0 0 16px; padding: 0;">
<li style="margin-top: 0; line-height: 1.6em; margin-left: 25px; padding-left: 3px;"><a href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-only" rel="nofollow noreferrer noopener" target="_blank" style="margin-top: 0;">https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-only</a></li>
<li style="line-height: 1.6em; margin-left: 25px; padding-left: 3px;"><a href="https://sublime-and-sphinx-guide.readthedocs.io/en/latest/conditions.html" rel="nofollow noreferrer noopener" target="_blank" style="margin-top: 0;">https://sublime-and-sphinx-guide.readthedocs.io/en/latest/conditions.html</a></li>
</ul>
<p dir="auto" style="color: #28272d; margin: 0;" align="initial">The nice thing is you can supply multiple tags so for non-deploy docs we can have both main and release active to see all the text instead of having to rebuild the docs.  This can be the default for HEAD and when building deploy docs just supply the one tag.</p>
</div>


</div>
<div class="footer" style="margin-top: 10px;">
<p style="font-size: small; color: #737278;">

<br>
<a href="https://gitlab.rtems.org/rtems/docs/rtems-docs/-/issues/100#note_120802">View it on GitLab</a>.
<br>
You're receiving this email because of your account on <a target="_blank" rel="noopener noreferrer" href="https://gitlab.rtems.org">gitlab.rtems.org</a>. <a href="https://gitlab.rtems.org/-/sent_notifications/9061543f7d6f8d4ac02b99599236b4f3/unsubscribe" target="_blank" rel="noopener noreferrer">Unsubscribe</a> from this thread · <a href="https://gitlab.rtems.org/-/profile/notifications" target="_blank" rel="noopener noreferrer" class="mng-notif-link">Manage all notifications</a> · <a href="https://gitlab.rtems.org/help" target="_blank" rel="noopener noreferrer" class="help-link">Help</a>
<script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","action":{"@type":"ViewAction","name":"View Issue","url":"https://gitlab.rtems.org/rtems/docs/rtems-docs/-/issues/100#note_120802"}}</script>


</p>
</div>
</body>
</html>