I want to interview users about doc - News - Canonical MAAS

<!DOCTYPE html> <html lang="en-GB"> <head> <meta charset="utf-8"> <title>I want to interview users about doc - News - Canonical MAAS | Discourse</title> <meta name="description" content="I want to make our MAAS doc better. I want to know what you think would make it better. All reported information from the interview will be completely anonymous. Bounce back to me here if you’re interested."> <meta name="generator" content="Discourse 3.3.0 - https://github.com/discourse/discourse version 5bbdc8a813caf55ab3147ac65b5ffafb5e0aab90"> <link rel="icon" type="image/png" href="https://discourse-maas-io-uploads.s3.us-east-1.amazonaws.com/optimized/2X/4/4e77f0ddaab1e5de1494ee1dca57b64a81994cf6_2_32x32.png"> <link rel="apple-touch-icon" type="image/png" href="https://discourse-maas-io-uploads.s3.us-east-1.amazonaws.com/optimized/2X/c/c318c28354414229c9195948cb03fdfb56b4cff0_2_180x180.png"> <meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff"> <meta name="theme-color" media="(prefers-color-scheme: dark)" content="#111111"> <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, user-scalable=yes, viewport-fit=cover"> <link rel="canonical" href="https://discourse.maas.io/t/i-want-to-interview-users-about-doc/7316" /> <link rel="search" type="application/opensearchdescription+xml" href="https://discourse.maas.io/opensearch.xml" title="Canonical MAAS | Discourse Search"> <link href="/stylesheets/color_definitions_base__22_2f70dc9c57f1d397546541daf48c1aa706732513.css?__ws=discourse.maas.io" media="all" rel="stylesheet" class="light-scheme"/><link href="/stylesheets/color_definitions_simple-dark_1_22_2546edebac924db66f86c1331b5de092d16e7b1d.css?__ws=discourse.maas.io" media="(prefers-color-scheme: dark)" rel="stylesheet" class="dark-scheme"/> <link href="/stylesheets/desktop_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="desktop" /> <link href="/stylesheets/checklist_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="checklist" /> <link href="/stylesheets/discourse-data-explorer_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-data-explorer" /> <link href="/stylesheets/discourse-details_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-details" /> <link href="/stylesheets/discourse-lazy-videos_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-lazy-videos" /> <link href="/stylesheets/discourse-local-dates_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-local-dates" /> <link href="/stylesheets/discourse-narrative-bot_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-narrative-bot" /> <link href="/stylesheets/discourse-presence_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-presence" /> <link href="/stylesheets/discourse-solved_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-solved" /> <link href="/stylesheets/discourse-templates_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="discourse-templates" /> <link href="/stylesheets/footnote_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="footnote" /> <link href="/stylesheets/markdown-note_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="markdown-note" /> <link href="/stylesheets/poll_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="poll" /> <link href="/stylesheets/spoiler-alert_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="spoiler-alert" /> <link href="/stylesheets/poll_desktop_1a06d260bd21bd010b1f41fd487cfaa02d691fff.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="poll_desktop" /> <link href="/stylesheets/desktop_theme_25_794fd0b9d522592959e398868a0631fca76e5dfc.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="desktop_theme" data-theme-id="25" data-theme-name="discotoc"/> <link href="/stylesheets/desktop_theme_22_622450c68323c34c2598fe9912a8d8c9a0dfce69.css?__ws=discourse.maas.io" media="all" rel="stylesheet" data-target="desktop_theme" data-theme-id="22" data-theme-name="maas discourse theme"/> <link href="https://fonts.googleapis.com/css?family=Ubuntu:300,400,700" rel="stylesheet" type="text/css">  <link rel="alternate nofollow" type="application/rss+xml" title="RSS feed of 'I want to interview users about doc'" href="https://discourse.maas.io/t/i-want-to-interview-users-about-doc/7316.rss" /> <meta property="og:site_name" content="Canonical MAAS | Discourse" /> <meta property="og:type" content="website" /> <meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:image" content="https://discourse-maas-io-uploads.s3.us-east-1.amazonaws.com/original/1X/6c4a10640cf18a3221d709f48a85927c586cdbac.jpg" /> <meta property="og:image" content="https://discourse-maas-io-uploads.s3.us-east-1.amazonaws.com/original/2X/c/c318c28354414229c9195948cb03fdfb56b4cff0.png" /> <meta property="og:url" content="https://discourse.maas.io/t/i-want-to-interview-users-about-doc/7316" /> <meta name="twitter:url" content="https://discourse.maas.io/t/i-want-to-interview-users-about-doc/7316" /> <meta property="og:title" content="I want to interview users about doc" /> <meta name="twitter:title" content="I want to interview users about doc" /> <meta property="og:description" content="I want to make our MAAS doc better. I want to know what you think would make it better. All reported information from the interview will be completely anonymous. Bounce back to me here if you’re interested." /> <meta name="twitter:description" content="I want to make our MAAS doc better. I want to know what you think would make it better. All reported information from the interview will be completely anonymous. Bounce back to me here if you’re interested." /> <meta property="og:article:section" content="News" /> <meta property="og:article:section:color" content="25AAE2" /> <meta name="twitter:label1" value="Reading time" /> <meta name="twitter:data1" value="1 mins 🕑" /> <meta name="twitter:label2" value="Likes" /> <meta name="twitter:data2" value="7 ❤" /> <meta property="article:published_time" content="2023-08-07T17:47:08+00:00" /> <meta property="og:ignore_canonical" content="true" /> <script type="application/ld+json">{"@context":"http://schema.org","@type":"QAPage","name":"I want to interview users about doc","mainEntity":{"@type":"Question","name":"I want to interview users about doc","text":"I want to make our MAAS doc better. I want to know what you think would make it better. All reported information from the interview will be completely anonymous. Bounce back to me here if you’re interested.","upvoteCount":4,"answerCount":0,"datePublished":"2023-08-07T17:47:08.565Z","author":{"@type":"Person","name":"billwear","url":"https://discourse.maas.io/u/billwear"}}}</script> </head> <body class="crawler browser-update"> <header id="navigation" class="p-navigation"> <div class="p-navigation__row"> <div div="" class="p-navigation__banner"> <div class="p-navigation__tagged-logo"> <a class="p-navigation__link" href="/" data-auto-route="true"> <div class="p-navigation__logo-tag"> <img class="p-navigation__logo-icon" src="https://assets.ubuntu.com/v1/0a863174-MAAS+logomark+only.svg" alt=""> </div> <span class="p-navigation__logo-title">Canonical MAAS</span> </a> </div> <a href="#navigation" class="p-navigation__toggle--open" title="menu">Menu</a> <a href="#navigation-closed" class="p-navigation__toggle--close" title="close menu">Close menu</a> </div> <nav class="p-navigation__nav" aria-label="main"> <ul id="main-navigation" class="p-navigation__items global-nav u-clearfix"> <li class="p-navigation__item"> <a class="p-navigation__link" href="https://maas.io/how-it-works">How it works</a> </li> <li class="p-navigation__item"> <a class="p-navigation__link" href="https://maas.io/install">Install</a> </li> <li class="p-navigation__item"> <a class="p-navigation__link" href="https://maas.io/docs">Docs</a> </li> <li class="p-navigation__item--dropdown-toggle" id="learn"> <a href="#learn-menu" aria-controls="learn-menu" class="p-navigation__link">Learn</a> <ul class="p-navigation__dropdown" id="learn-menu" aria-hidden="true"> <li> <a class="p-navigation__dropdown-item" href="https://maas.io/tour">Features</a> </li> <li> <a class="p-navigation__dropdown-item" href="https://maas.io/tutorials">Tutorials</a> </li> <li> <a class="p-navigation__dropdown-item" href="https://maas.io/resources">Understand MAAS</a> </li> <li> <a class="p-navigation__dropdown-item" href="https://maas.io/blog">Blog</a> </li> </ul> </li> </ul> </nav> </div> </header> <nav class="p-navigation--secondary"> <div class="u-fixed-width"> <a class="p-navigation--secondary__banner" href="/"> <h5 class="p-navigation--secondary__logo">Discourse</h5> </a> </div> </nav> <header> <a href="/"> Canonical MAAS | Discourse </a> </header> <div id="main-outlet" class="wrap" role="main"> <div id="topic-title"> <h1> <a href="/t/i-want-to-interview-users-about-doc/7316">I want to interview users about doc</a> </h1> <div class="topic-category" itemscope itemtype="http://schema.org/BreadcrumbList"> <span itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"> <a href="/c/news/7" class="badge-wrapper bullet" itemprop="item"> <span class='badge-category-bg' style='background-color: #25AAE2'></span> <span class='badge-category clear-badge'> <span class='category-name' itemprop='name'>News</span> </span> </a> <meta itemprop="position" content="1" /> </span> </div> </div> <div itemscope itemtype='http://schema.org/DiscussionForumPosting'> <meta itemprop='headline' content='I want to interview users about doc'> <link itemprop='url' href='https://discourse.maas.io/t/i-want-to-interview-users-about-doc/7316'> <meta itemprop='datePublished' content='2023-08-07T17:47:08Z'> <meta itemprop='articleSection' content='News'> <meta itemprop='keywords' content=''> <div itemprop='publisher' itemscope itemtype="http://schema.org/Organization"> <meta itemprop='name' content='Canonical'> <div itemprop='logo' itemscope itemtype="http://schema.org/ImageObject"> <meta itemprop='url' content='https://discourse-maas-io-uploads.s3.us-east-1.amazonaws.com/original/2X/8/8003899a00283bcc2dd4ef9ce8120d9ddebd44d7.svg'> </div> </div> <div id='post_1' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/billwear'><span itemprop='name'>billwear</span></a> </span> <link itemprop="mainEntityOfPage" href="https://discourse.maas.io/t/i-want-to-interview-users-about-doc/7316"> <span class="crawler-post-infos"> <time datetime='2023-08-07T17:47:08Z' class='post-time'> 7 August 2023 17:47 </time> <meta itemprop='dateModified' content='2023-08-07T17:47:08Z'> <span itemprop='position'>1</span> </span> </div> <div class='post' itemprop='text'> <p>I want to make our MAAS doc better. I want to know what you think would make it better. All reported information from the interview will be completely anonymous. Bounce back to me here if you’re interested.</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="4" /> <span class='post-likes'>4 Likes</span> </div> </div> <div id='post_2' itemprop='comment' itemscope itemtype='http://schema.org/Comment' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/j-klare'><span itemprop='name'>j-klare</span></a> </span> <span class="crawler-post-infos"> <time itemprop='datePublished' datetime='2023-08-15T10:14:39Z' class='post-time'> 15 August 2023 10:14 </time> <meta itemprop='dateModified' content='2023-08-15T10:14:39Z'> <span itemprop='position'>2</span> </span> </div> <div class='post' itemprop='text'> <p>I am up for providing some feedback.</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="1" /> <span class='post-likes'>1 Like</span> </div> </div> <div id='post_3' itemprop='comment' itemscope itemtype='http://schema.org/Comment' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/bmcnally-uw'><span itemprop='name'>bmcnally-uw</span></a> </span> <span class="crawler-post-infos"> <time itemprop='datePublished' datetime='2023-08-15T16:29:57Z' class='post-time'> 15 August 2023 16:29 </time> <meta itemprop='dateModified' content='2023-08-15T16:29:57Z'> <span itemprop='position'>3</span> </span> </div> <div class='post' itemprop='text'> <p>Same, hit me up if you’d like some feedback.</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="1" /> <span class='post-likes'>1 Like</span> </div> </div> <div id='post_4' itemprop='comment' itemscope itemtype='http://schema.org/Comment' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/billwear'><span itemprop='name'>billwear</span></a> </span> <span class="crawler-post-infos"> <time itemprop='datePublished' datetime='2023-08-15T16:41:45Z' class='post-time'> 15 August 2023 16:41 </time> <meta itemprop='dateModified' content='2023-08-15T16:41:45Z'> <span itemprop='position'>4</span> </span> </div> <div class='post' itemprop='text'> <p>cool. my email is <a href="mailto:bill.wear@canonical.com">bill.wear@canonical.com</a>. let’s work out a time that works for you, and we’ll set up a video call.</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="0" /> <span class='post-likes'></span> </div> </div> <div id='post_5' itemprop='comment' itemscope itemtype='http://schema.org/Comment' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/billwear'><span itemprop='name'>billwear</span></a> </span> <span class="crawler-post-infos"> <time itemprop='datePublished' datetime='2023-08-15T16:42:26Z' class='post-time'> 15 August 2023 16:42 </time> <meta itemprop='dateModified' content='2023-08-15T16:42:26Z'> <span itemprop='position'>5</span> </span> </div> <div class='post' itemprop='text'> <p>excellent, ping me at <a href="mailto:bill.wear@canonical.com">bill.wear@canonical.com</a> and let me know when you’re available; let’s work out a time that works well for you, so we can chat.</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="0" /> <span class='post-likes'></span> </div> </div> <div id='post_6' itemprop='comment' itemscope itemtype='http://schema.org/Comment' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/billwear'><span itemprop='name'>billwear</span></a> </span> <span class="crawler-post-infos"> <time itemprop='datePublished' datetime='2023-08-18T16:03:29Z' class='post-time'> 18 August 2023 16:03 </time> <meta itemprop='dateModified' content='2023-08-18T16:03:29Z'> <span itemprop='position'>6</span> </span> </div> <div class='post' itemprop='text'> <p><a class="mention" href="/u/j-klare">@j-klare</a>, <a class="mention" href="/u/bmcnally-uw">@bmcnally-uw</a>: please go <a href="https://calendly.com/maas-dev-advocate/30min">here</a> to book some time with me to discuss documentation! eager to hear your feedback.</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="0" /> <span class='post-likes'></span> </div> </div> <div id='post_7' itemprop='comment' itemscope itemtype='http://schema.org/Comment' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/timblaktu'><span itemprop='name'>timblaktu</span></a> </span> <span class="crawler-post-infos"> <time itemprop='datePublished' datetime='2023-08-18T21:56:51Z' class='post-time'> 18 August 2023 21:56 </time> <meta itemprop='dateModified' content='2023-08-18T21:56:51Z'> <span itemprop='position'>7</span> </span> </div> <div class='post' itemprop='text'> <p>Make it clear WHERE the documentation lives for a particular version. This took me a while and I’m still not sure but it seems these discourse posts are the best place for docs for the 3.4-beta.</p> <p>Document the complete flow for setting up the simplest 1-machine Maas region+rack controller, with real database (not the test one). I’ve spent a week trying to do this with a bare metal ubuntu 22.04 minimal server, and I yave yet to see MaaS work in its simplest form (just want it to come up, and have PXE boot / discovery and commissioning work.) I’ll start another thread on that.</p> <p>Thanks for your hard work, and engaging the community on this!</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="1" /> <span class='post-likes'>1 Like</span> </div> </div> <div id='post_8' itemprop='comment' itemscope itemtype='http://schema.org/Comment' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.maas.io/u/pkr'><span itemprop='name'>pkr</span></a> </span> <span class="crawler-post-infos"> <time itemprop='datePublished' datetime='2023-08-20T00:04:28Z' class='post-time'> 20 August 2023 00:04 </time> <meta itemprop='dateModified' content='2023-08-20T00:04:28Z'> <span itemprop='position'>8</span> </span> </div> <div class='post' itemprop='text'> <p>being new to MAAS, i have struggled w/ the current documentation, especially the quick start guide is missing quite a lot of information, and yet my installation is incomplete</p> <p>happy to contribute, lmk</p> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="0" /> <span class='post-likes'></span> </div> </div> </div> </div> <footer class="container wrap"> <nav class='crawler-nav'> <ul> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='/' itemprop="url">Home </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='/categories' itemprop="url">Categories </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='/guidelines' itemprop="url">Guidelines </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='https://ubuntu.com/legal' itemprop="url">Terms of Service </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='https://ubuntu.com/legal' itemprop="url">Privacy Policy </a> </span> </li> </ul> </nav> <p class='powered-by-link'>Powered by <a href="https://www.discourse.org">Discourse</a>, best viewed with JavaScript enabled</p> </footer> <script src="https://maas.io/static/js/modules/global-nav/global-nav.js" nonce="oFbfDslEDXkVgHqnwUTFmhjAe"></script> <script defer="" src="/theme-javascripts/24a51ea01a4af2323c7693ce36821863c46419a9.js?__ws=discourse.maas.io" data-theme-id="22" nonce="oFbfDslEDXkVgHqnwUTFmhjAe"></script> <div class="buorg"><div>Unfortunately, <a href="https://www.discourse.org/faq/#browser">your browser is unsupported</a>. Please <a href="https://browsehappy.com">switch to a supported browser</a> to view rich content, log in and reply.</div></div> </body> </html>

CINXE.COM

I want to interview users about doc - News - Canonical MAAS | Discourse