dist/start.html

<!DOCTYPE html>
<!--[if IE 8]> <html lang="en" class="ie8"> <![endif]-->
<!--[if IE 9]> <html lang="en" class="ie9"> <![endif]-->
<!--[if !IE]><!--> <html lang="en"> <!--<![endif]-->
<head>
    <title>Zube Docs | Getting Started</title>
    <!-- Meta -->
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <meta name="description" content="Getting started with Zube's Agile project management workflow components.">
    <link rel="icon" type="image/ico" href="/docs/favicons/76806d705602d86fde0ff7533a567bcd.favicon.ico">
    <link rel="apple-touch-icon" sizes="57x57" href="/docs/favicons/4ee898306d181155970a3ec379fea6b5.apple-icon-57x57.png">
    <link rel="apple-touch-icon" sizes="60x60" href="/docs/favicons/a7cbf04e1e51ceffd5b8b4715caa9bec.apple-icon-60x60.png">
    <link rel="apple-touch-icon" sizes="72x72" href="/docs/favicons/45a0045b5828a0c8719175df9cff4d73.apple-icon-72x72.png">
    <link rel="apple-touch-icon" sizes="76x76" href="/docs/favicons/99bd244d78e20f6a8b6384ac6b450c95.apple-icon-76x76.png">
    <link rel="apple-touch-icon" sizes="114x114" href="/docs/favicons/0df6ea3629cd40e9b11bd3b0c793a998.apple-icon-114x114.png">
    <link rel="apple-touch-icon" sizes="120x120" href="/docs/favicons/21a05b3a4a7db786a72082f5aa74f9b8.apple-icon-120x120.png">
    <link rel="apple-touch-icon" sizes="144x144" href="/docs/favicons/be4b6500f270210c3437facd3322c28b.apple-icon-144x144.png">
    <link rel="apple-touch-icon" sizes="152x152" href="/docs/favicons/4152852cd3be1207fb77de56a272a6cc.apple-icon-152x152.png">
    <link rel="apple-touch-icon" sizes="180x180" href="/docs/favicons/083e6470c41a37c8dbb5b5d4206078b5.apple-icon-180x180.png">
    <link rel="icon" type="image/png" sizes="192x192" href="/docs/favicons/a82779e90d4d46deb2dbc68e0971352b.android-icon-192x192.png">
    <link rel="icon" type="image/png" sizes="32x32" href="/docs/favicons/20612186ed82559c9ddfff6f843ef1f4.favicon-32x32.png">
    <link rel="icon" type="image/png" sizes="96x96" href="/docs/favicons/9437c2b344073f0867b0f3f15179dd35.favicon-96x96.png">
    <link rel="icon" type="image/png" sizes="16x16" href="/docs/favicons/2bdcc1c418cd50d7b58214b7ccf083a8.favicon-16x16.png">
    <link rel="manifest" href="/docs/favicons/b58fcfa7628c9205cb11a1b2c3e8f99a.manifest.json">
    <meta name="msapplication-TileColor" content="#ffffff">
    <meta name="msapplication-TileImage" content="/docs/favicons/be4b6500f270210c3437facd3322c28b.ms-icon-144x144.png">
    <meta name="theme-color" content="#ffffff">
    <link href="https://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800" rel="stylesheet" type="text/css">
    <link href="//fonts.googleapis.com/css?family=Lato:300,400" rel="stylesheet" type="text/css">

    <link rel="stylesheet" href="/docs/styles/c27c4f91ae58aafe89b55170dbcacd3a.main.css">

    <script src="/docs/scripts/f1eb1d6831216d089fe1c9201cfd2076.vendor.js"></script>

    <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
    <!--[if lt IE 9]>
      <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
      <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->

</head>

<body class="body-blue">
    <div class="page-wrapper">
        <!-- ******Header****** -->
        <header id="header" class="header">
            <div id="back-to-zube">
                <a href="/"><i class="zubeicon-home"></i> Back to Zube</a>
            </div>
            <div class="container">
                <div class="branding">
                    <h1 class="logo">
                        <a href="/docs">
                            <span aria-hidden="true" class="zubeicon-zube-mark icon"></span>
                            <span class="text-bold">Zube</span> <span class="text-highlight">Docs</span>
                        </a>
                    </h1>
                </div><!--//branding-->
                <ol class="breadcrumb">
                    <li><a href="/docs">Home</a></li>
                    <li class="active">Getting Started</li>
                </ol>
            </div><!--//container-->
        </header><!--//header-->
        <div class="doc-wrapper">
            <div class="container">
                <div id="doc-header" class="doc-header text-center">
                    <h1 class="doc-title"><i class="icon fa fa-paper-plane"></i> Getting Started</h1>
                    <div class="meta"><i class="fa fa-clock-o"></i> Last updated: Sept 25, 2021</div>
                </div><!--//doc-header-->
                <div class="doc-body">
                    <div class="doc-content">
                        <div class="content-inner">
                            <section id="signup-section" class="doc-section">
                                <h2 class="section-title">Sign Up</h2>
                                <p>
                                    You can get started using Zube by signing up with either GitHub or Google OAuth.
                                </p>
                                <div class="callout-block callout-info">
                                    <div class="icon-holder">
                                        <i class="fa fa-info-circle"></i>
                                    </div><!--//icon-holder-->
                                    <div class="content">
                                        <h4 class="callout-title">Hint:</h4>
                                        <p>
                                            You must use GitHub authentication to import GitHub repositories into Zube.
                                        </p>
                                    </div><!--//content-->
                                </div>

                                <div id="github-auth" class="section-block">
                                    <h3 class="block-title">GitHub Authentication</h3>
                                    <a class="btn provider-btn github-btn btn-login btn-signup word-wrap" href="/auth/github">
                                        <img class="vendor-icon" src="/docs/images/45a5031c69de90b6facb2d53e62b1677.github_login_btn.svg" alt="GitHub">
                                        <span>Sign up with GitHub</span>
                                    </a>
                                    <p>
                                        Logging in with GitHub allows you to change your GitHub Issues data directly from Zube. If you have a GitHub account and are using Zube for software development, you'll want to choose this option. Using GitHub authentication will allow you create new GitHub Issues directly from Zube as well as comment as yourself.
                                    </p>
                                    <div class="callout-block callout-success">
                                        <div class="icon-holder">
                                            <i class="fa fa-thumbs-up"></i>
                                        </div><!--//icon-holder-->
                                        <div class="content">
                                            <h4 class="callout-title">Tip:</h4>
                                            <p>
                                                GitHub requires write access to your repositories in order to manage Issues, however Zube never reads from or writes to your source code in any way. Zube only accesses information related to GitHub Issues.
                                            </p>
                                        </div><!--//content-->
                                    </div>
                                </div><!--//section-block-->
                                <div id="google-auth" class="section-block">
                                    <h3 class="block-title">Google Authentication</h3>
                                    <a class="btn provider-btn google-btn btn-login btn-signup word-wrap" href="/auth/google">
                                        <img class="vendor-icon" src="/docs/images/49ecdd2fe890ff864bdfb1d71566efdc.google_login_btn.svg" alt="Google">
                                        <span>Sign up with Google</span>
                                    </a>
                                    <p>
                                        Logging in with Google is easy and secure.
                                    </p>
                                    <div class="callout-block callout-success">
                                        <div class="icon-holder">
                                            <i class="fa fa-thumbs-up"></i>
                                        </div><!--//icon-holder-->
                                        <div class="content">
                                            <h4 class="callout-title">Tip:</h4>
                                            <p>
                                                If you have multiple Google accounts make sure you choose the appropriate account. For example, you may have a personal email account like your.name@gmail.com and a work email like name@company.com. You'll most likely want to choose your work account when signing up for Zube.
                                            </p>
                                        </div><!--//content-->
                                    </div>
                                </div><!--//section-block-->
                            </section><!--//doc-section-->

                            <section id="organizations-section" class="doc-section">
                                <h2 class="section-title">Organizations</h2>
                                <p>
                                    Zube organizations are the home base for your different projects. After logging into Zube, you will be able to either create a new organization or join an existing organization.
                                </p>
                                <div class="screenshot-holder">
                                    <a href="/docs/images/d194f4738d6ccbd637a6d98831704548.welcome_screen.png" data-toggle="lightbox" data-title="Welcome Page"><img class="img-responsive" src="/docs/images/d194f4738d6ccbd637a6d98831704548.welcome_screen.png" alt="screenshot"></a>
                                    <a class="mask" href="/docs/images/d194f4738d6ccbd637a6d98831704548.welcome_screen.png" data-toggle="lightbox" data-title="Welcome Page"><i class="icon fa fa-search-plus"></i></a>
                                </div>
                                <div class="callout-block callout-success">
                                    <div class="icon-holder">
                                        <i class="fa fa-info-circle"></i>
                                    </div><!--//icon-holder-->
                                    <div class="content">
                                        <h4 class="callout-title">Tip:</h4>
                                        <p>
                                            If you signed up with GitHub and are a collaborator on GitHub repositories that are being managed in Zube, you will be automatically added to those projects. To create a new organization, click the blue button at the top right of the page.
                                        </p>
                                    </div><!--//content-->
                                </div><!--//callout-block-->
                                <p>
                                    <small>If you signed up for Zube through the GitHub Marketplace, your organization will be created automatically and you will be prompted to create your first Project. <strong><a href="#project-section">Skip to Creating a Project</a></strong>.</small>
                                </p>

                                <div id="create-organization-section" class="section-block">
                                    <h3 class="block-title">Create an Organization</h3>
                                    <p>
                                        To create a new organization on Zube, click "Create a new Organization" button to bring up the new organization form. If you logged in with GitHub, you'll have the option to add a GitHub organization. Enter your organization name, select a GitHub organization (optional) and click 'Create Organization'.
                                    </p>
                                    <div class="screenshot-holder">
                                        <a href="/docs/images/856e6e6b07ef1590e4dc2756e4b59b95.create_organization.png" data-toggle="lightbox" data-title="Create an Organization"><img class="img-responsive" src="/docs/images/856e6e6b07ef1590e4dc2756e4b59b95.create_organization.png" alt="screenshot"></a>
                                        <a class="mask" href="/docs/images/856e6e6b07ef1590e4dc2756e4b59b95.create_organization.png" data-toggle="lightbox" data-title="Create an Organization"><i class="icon fa fa-search-plus"></i></a>
                                    </div>
                                    <div class="callout-block callout-success">
                                    <div class="icon-holder">
                                        <i class="fa fa-info-circle"></i>
                                    </div><!--//icon-holder-->
                                    <div class="content">
                                        <h4 class="callout-title">Tip:</h4>
                                        <p>
                                            Optionally, you can link a GitHub organization to your Zube organization. You'll want to go this route if you'd like to use Zube to help manage your GitHub Issues. Note that a GitHub organization can be linked to one and only one Zube organization.
                                        </p>
                                    </div><!--//content-->
                                </div><!--//callout-block-->
                                </div><!--//section-block-->
                                <div id="create-project-section" class="section-block">
                                    <h3 class="block-title">Create a Project</h3>
                                    <p>
                                        After you create a new organization, it's time to make the first Project for your organization. Projects are the highest level containers for your workflow on Zube and contain project management components such as Tickets, Triage and Workspaces.
                                    </p>
                                    <p>
                                        If your organization is linked to a GitHub organization (and you have signed in with GitHub), you'll be able to select one or more source repositories to import into your Project. Projects can have many source repos, but source repos can only belong to one Project. Give your Project a name, description and optionally link one or more GitHub source repositories. When you're ready, click 'Create Project'.
                                    </p>
                                    <div class="screenshot-holder">
                                        <a href="/docs/images/93018b7e225e7aa593ca987ef641f6aa.create_project.png" data-toggle="lightbox" data-title="Create a Project"><img class="img-responsive" src="/docs/images/93018b7e225e7aa593ca987ef641f6aa.create_project.png" alt="screenshot"></a>
                                        <a class="mask" href="/docs/images/93018b7e225e7aa593ca987ef641f6aa.create_project.png" data-toggle="lightbox" data-title="Create a Project"><i class="icon fa fa-search-plus"></i></a>
                                    </div>

                                    <p>
                                        If you attached any GitHub repositories to your Project, Zube will import the Issues from those repos to your Project. Once the import is complete, you'll be redirected to your Workspace where you can begin managing your project!
                                    </p>
                                </div>

                                <div id="join-organization-section" class="section-block">
                                    <h3 class="block-title">Join an Organization</h3>
                                    <p>
                                        To join an existing organization on Zube, click "Join an existing Organization" button to bring up the organization search form. If you signed in with your GitHub account and have access to a GitHub organization already linked to a Zube organization, you be able to select it from the GitHub organization drop down list.
                                    </p>
                                    <p>
                                        You can also use the organization search box to search for a Zube organization by name. Selecting a Zube organization by name will send an approval request to the organization admins. Organization admins can either approve the request, which will add the requester to the organization, or deny the request.
                                    </p>
                                    <div class="screenshot-holder">
                                        <a href="/docs/images/e4b2e99da3ae60e885c2014da2ddc4ee.join_organization.png" data-toggle="lightbox" data-title="Join an Organization"><img class="img-responsive" src="/docs/images/e4b2e99da3ae60e885c2014da2ddc4ee.join_organization.png" alt="screenshot"></a>
                                        <a class="mask" href="/docs/images/e4b2e99da3ae60e885c2014da2ddc4ee.join_organization.png" data-toggle="lightbox" data-title="Join an Organization"><i class="icon fa fa-search-plus"></i></a>
                                    </div>
                                </div><!--//section-block-->
                            </section><!--//doc-section-->

                            <section id="team-section" class="doc-section">
                                <h2 class="section-title">Adding Team Members</h2>
                                <p>
                                    Once you've created your first Project, you'll probably want to have the rest of your team join in as well. To add team members to your Project, they must be part of your organization.
                                </p>
                                <p>
                                    To add new team members, go to the organization settings page. Under the Organization Members' tab, you'll see a list of the organization admins and members and a search box to look for teammates on Zube. You can send email invitations to your team members via the "Invite Team Members" form. If your team members have already joined Zube, you can use the search box to find them by name, username, or email address.
                                </p>
                                <p>
                                    If your organization is linked to a GitHub organization, you will also see a list of GitHub Collaborators. This is a list of people who are collaborators on your project sources but are not members of your Zube organization. You can use the invite form to send them an email inviting them to join your Zube organization.
                                </p>
                                <div class="screenshot-holder">
                                    <a href="/docs/images/b603f7900fd6cbdbcced086e6163c941.add_team_members.png" data-toggle="lightbox" data-title="Add Team Members to an Organization"><img class="img-responsive" src="/docs/images/b603f7900fd6cbdbcced086e6163c941.add_team_members.png" alt="screenshot"></a>
                                    <a class="mask" href="/docs/images/b603f7900fd6cbdbcced086e6163c941.add_team_members.png" data-toggle="lightbox" data-title="Add Team Members to an Organization"><i class="icon fa fa-search-plus"></i></a>
                                </div>

                                Once your team members have been added to your Zube organization, you can add them to any of your Zube Projects. Team members can be added to Projects via the Project Settings page for each project under the 'Users' tab.

                                <div class="callout-block callout-success">
                                    <div class="icon-holder">
                                        <i class="fa fa-thumbs-up"></i>
                                    </div><!--//icon-holder-->
                                    <div class="content">
                                        <h4 class="callout-title">Tip:</h4>
                                        <p>
                                            Team members who sign up with GitHub and are collaborators on GitHub repositories that are being managed in Zube, they will be automatically added to your organization.
                                        </p>
                                    </div><!--//content-->
                                </div>

                                <div class="callout-block callout-default">
                                    <div class="icon-holder">
                                        <i class="fa fa-file-text"></i>
                                    </div><!--//icon-holder-->
                                    <div class="content">
                                        <h4 class="callout-title">TL;DR:</h4>
                                        <p>
                                            You can invite new team members to Zube or search for people already on Zube to add to your organization. Once team members are on your organization, you can add team members to any of your organization projects.
                                        </p>
                                    </div><!--//content-->
                                </div>
                            </section><!--//doc-section-->


                            <section id="zubebot-section" class="doc-section">
                                <h2 class="section-title">The Zubebot GitHub Integration</h2>
                                <p>
                                    If your organization has a linked GitHub organization, we recommend installing the Zubebot GitHub Integration to make communication across your team seamless. The Zubebot allows your non-technical team members and team members with read-only access to your source repositories to communicate with your developers without giving them write access to your GitHub repositories.
                                </p>

                                <div class="callout-block callout-info">
                                    <div class="icon-holder">
                                        <i class="fa fa-info-circle"></i>
                                    </div><!--//icon-holder-->
                                    <div class="content">
                                        <h4 class="callout-title">Hint:</h4>
                                        <p>
                                            You must be an owner of the GitHub organization to install the Zubebot GitHub integration.
                                        </p>
                                    </div><!--//content-->
                                </div><!--//callout-block-->

                                <div id="adding-zubebot-section" class="section-block">
                                    <h3 class="block-title">Adding the Zubebot to Your Organization</h3>
                                    <p>
                                        To add the Zubebot GitHub integration to your organization:
                                    </p>

                                    <ol class="list">
                                        <li>On Zube, navigate to your Zube organization's settings page and click the Integrations tab.
                                        <br><br>Note: You can get to your Zube organization's settings page via the <a href="https://zube.io" target="_blank">homepage</a> by clicking the "organization settings" link next to the name of your organization.</li>
                                        <li>Make sure there is a GitHub organization linked to your Zube organization. If not, link your GitHub organization.</li>
                                        <li>Click the 'Install Zubebot' button.</li>
                                        <li>In the new window, click the 'Install' button (or 'Configure' button).</li>
                                        <li>If you are the owner of multiple GitHub organizations, choose the appropriate GitHub organization.</li>
                                        <li>Select the repositories you want to give the integration access to (we recommend selecting 'All repositories')</li>
                                        <li>Click the install button at the bottom of the screen to authorize the Zubebot integration</li>
                                        <li>
                                            Navigate back to Zube, sit back and enjoy seamless communication across your entire team!
                                            <br><small>* Your browser should automatically refresh to pull in the changes.</small>
                                        </li>
                                    </ol>

                                    <div class="callout-block callout-success">
                                        <div class="icon-holder">
                                            <i class="fa fa-thumbs-up"></i>
                                        </div><!--//icon-holder-->
                                        <div class="content">
                                            <h4 class="callout-title">Tip:</h4>
                                            <p>
                                                The Zubebot allows your non GitHub team members to comment on, edit, close and reopen cards that are backed by GitHub Issues.
                                            </p>
                                        </div><!--//content-->
                                    </div>
                                </div><!--//section-block-->
                            </section><!--//doc-section-->

                            <section class="doc-section clearfix">
                                <a class="btn btn-primary pull-right" href="/docs/components">Next: Learn about Zube Agile project management components</a>
                            </section><!--//doc-section-->

                            <div class="section-block">
                                <div class="callout-block contact-callout">
                                    <div class="content">
                                        <p>
                                            Have more questions? Need help setting up your workflow? Get in touch!
                                        </p>
                                        <p>
                                            <a href="mailto:team@zube.io" target="_top"><i class="zubeicon-envelope"></i> team@zube.io</a>
                                            <a href="http://slack.zube.io" target="_blank"><i class="zubeicon-slack"></i> Zube on Slack</a>
                                        </p>
                                    </div><!--//content-->
                                </div><!--//callout-block-->
                            </div>
                        </div><!--//content-inner-->
                    </div><!--//doc-content-->

                    <div class="doc-sidebar hidden-xs">
                        <nav id="doc-nav">
                            <ul id="doc-menu" class="nav doc-menu" data-spy="affix">
                                <li>
                                    <a class="scrollto" href="#signup-section">Sign up</a>
                                    <ul class="nav doc-sub-menu">
                                        <li><a class="scrollto" href="#github-auth">GitHub Authentication</a></li>
                                        <li><a class="scrollto" href="#google-auth">Google Authentication</a></li>
                                    </ul><!--//nav-->
                                </li>
                                <li>
                                    <a class="scrollto" href="#organizations-section">Organizations</a>
                                    <ul class="nav doc-sub-menu">
                                        <li><a class="scrollto" href="#create-organization-section">Create an Organization</a></li>
                                        <li><a class="scrollto" href="#create-project-section">Create a Project</a></li>
                                        <li><a class="scrollto" href="#join-organization-section">Join an existing Organization</a></li>
                                    </ul><!--//nav-->
                                </li>
                                <li><a class="scrollto" href="#team-section">Adding Team Members</a></li>
                                <li>
                                    <a class="scrollto" href="#zubebot-section">Zubebot GitHub Integration</a>
                                    <ul class="nav doc-sub-menu">
                                        <li><a class="scrollto" href="#adding-zubebot-section">Adding the Zubebot</a></li>
                                    </ul><!--//nav-->
                                </li>
                            </ul><!--//doc-menu-->
                        </nav>
                    </div><!--//doc-sidebar-->
                </div><!--//doc-body-->
            </div><!--//container-->
        </div><!--//doc-wrapper-->

    </div><!--//page-wrapper-->

    <footer id="footer" class="footer text-center">
        <div class="container">
            <div class="row">
                <div class="col-lg-12">
                    <ul class="list-inline">
                        <li><a href="/">Home</a></li>
                        <li>&sdot;</li>
                        <li><a href="/contact">Contact</a></li>
                        <li>&sdot;</li>
                        <li><a href="/blog">Blog</a></li>
                        <li>&sdot;</li>
                        <li><a href="/tos">Terms and Privacy</a></li>
                    </ul>
                    <p class="copyright text-center medium">Copyright &copy; Pivit Inc. <span id="copyright-date"></span>. All Rights Reserved</p>
                </div>
            </div>
        </div><!--//container-->
    </footer><!--//footer-->

    <!-- Tracking -->
    <script>
        if (location.hostname === 'zube.io') {
            // google
            (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
            (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
            m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
            })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

            ga('create', 'UA-59920113-2', 'auto');
            ga('send', 'pageview');

        } else {
            window.ga = function () {}; // noop
        }
    </script>

    <script>
      $('#copyright-date').html(new Date().getFullYear());
    </script>
</body>
</html>