engineers-log-69525c451538.html


<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <meta name="HandheldFriendly" content="True" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <meta name="robots" content="" />

  <link href="https://fonts.googleapis.com/css2?family=Source+Code+Pro:ital,wght@0,400;0,700;1,400&family=Source+Sans+Pro:ital,wght@0,300;0,400;0,700;1,400&display=swap" rel="stylesheet">

    <link rel="stylesheet" type="text/css" href="./theme/stylesheet/style.min.css">


    <link id="pygments-light-theme" rel="stylesheet" type="text/css"
          href="./theme/pygments/github.min.css">


  <link rel="stylesheet" type="text/css" href="./theme/font-awesome/css/fontawesome.css">
  <link rel="stylesheet" type="text/css" href="./theme/font-awesome/css/brands.css">
  <link rel="stylesheet" type="text/css" href="./theme/font-awesome/css/solid.css">


  <link href="https://shanedowling.com/feeds/all.atom.xml" type="application/atom+xml" rel="alternate" title="Shane Dowling Atom">

  <link href="https://shanedowling.com/feeds/all.rss.xml" type="application/rss+xml" rel="alternate" title="Shane Dowling RSS">

<script type="text/javascript">
  (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', 'G-Z9P3V6D0SV', 'auto');
  ga('send', 'pageview');
</script>


<meta name="author" content="Shane Dowling" />
<meta name="description" content="Four years ago(to the day) I wrote a post on why I was Giving up on wikis and I have to admit, four years later my opinions on the topic really haven&#39;t changed. It&#39;s been 4 years, 700 questions(with 800 answers) and several server moves later and by …" />
<meta name="keywords" content="">


  <meta property="og:site_name" content="Shane Dowling"/>
  <meta property="og:title" content="Engineers Log"/>
  <meta property="og:description" content="Four years ago(to the day) I wrote a post on why I was Giving up on wikis and I have to admit, four years later my opinions on the topic really haven&#39;t changed. It&#39;s been 4 years, 700 questions(with 800 answers) and several server moves later and by …"/>
  <meta property="og:locale" content="en_US"/>
  <meta property="og:url" content="./engineers-log-69525c451538.html"/>
  <meta property="og:type" content="article"/>
  <meta property="article:published_time" content="2014-06-15 00:00:00+00:00"/>
  <meta property="article:modified_time" content=""/>
  <meta property="article:author" content="./author/shane-dowling.html">
  <meta property="article:section" content="Productivity"/>
  <meta property="og:image" content="/images/logo.png">

  <title>Shane Dowling &ndash; Engineers Log</title>


</head>
<body class="light-theme">

<aside>
  <div>
    <a href="./">
      <img src="/images/logo.png" alt="Shane Dowling" title="Shane Dowling">
    </a>

    <h1>
      <a href="./">Shane Dowling</a>
    </h1>

    <p>Platform Engineering Manager</p>


    <nav>
      <ul class="list">


            <li>
              <a target="_self"
                 href="./pages/contact.html#contact">
                Contact
              </a>
            </li>
            <li>
              <a target="_self"
                 href="./pages/now-page.html#now-page">
                Now Page
              </a>
            </li>
            <li>
              <a target="_self"
                 href="./pages/statuslog.html#statuslog">
                Statuslog
              </a>
            </li>

          <li>
            <a target="_self" href="https://hybridcloudshow.com/" >podcast</a>
          </li>
          <li>
            <a target="_self" href="https://pemonthly.com/" >newsletter</a>
          </li>
      </ul>
    </nav>

    <ul class="social">
      <li>
        <a class="sc-github"
           href="https://github.com/shano"
           target="_blank">
          <i class="fa-brands fa-github"></i>
        </a>
      </li>
      <li>
        <a class="sc-mastodon"
rel="me"           href="https://social.lol/@sed"
           target="_blank">
          <i class="fa-brands fa-mastodon"></i>
        </a>
      </li>
      <li>
        <a class="sc-linkedin"
           href="https://www.linkedin.com/in/shanedow/"
           target="_blank">
          <i class="fa-brands fa-linkedin"></i>
        </a>
      </li>
      <li>
        <a class="sc-bsky"
           href="https://bsky.app/profile/shandow.bsky.social"
           target="_blank">
          <i class="fa-brands fa-bsky"></i>
        </a>
      </li>
    </ul>
  </div>

</aside>
  <main>


<article class="single">
  <header>
      
    <h1 id="engineers-log-69525c451538">Engineers Log</h1>
    <p>
      Posted on Sun 15 June 2014 in <a href="./category/productivity.html">Productivity</a>

    </p>
  </header>


  <div>
    <p><img alt="" src="images/1__u5I9tVI8pJKp8tTRe1__AqA.jpeg"></p>
<p>Four years ago(to the day) I wrote a post on why I was <a href="http://shanedowling.com/giving-up-on-wikis/">Giving up on wikis</a> and I have to admit, four years later my opinions on the topic really haven't changed.</p>
<p>It's been 4 years, 700 questions(with 800 answers) and several server
moves later and by and large the process hasn't changed all that much,
everything is just little more streamlined.</p>
<h3>Tagging:</h3>
<p>When I started I simply used tagging to reflect the technology the</p>
<ul>
<li>I tag company sensitive questions with the company name, so if I ever leave that place, I can easily find/drop questions with company sensitive info.</li>
<li>A lot of the time, I notice that a solution I'm entering is worthy of a blog post. I tend to flag my questions as to-blog, so when I'm looking for writing inspiration it's pretty easy to start writing when you've got a list of essentially half-complete posts waiting for you.</li>
<li>Sometimes I gave internal access my OSQA install to companies I worked for. If I was writing rough documentation for a specific team I would create tags for them to review my "documents" while I was writing them up.</li>
</ul>
<h3>Scripts:</h3>
<p>Originally I stored my scripts with some comments in a standard
~/scripts folder and grep when I needed functionality. This solution
always ended up getting messy to me so I moved them to my OSQA install.
They're much tidier up there personally, I drill-down into the scripts
tag then filter with what I need. Plus OSQA stores every revision of a
question/answer so I can easily peruse old variants. I'm aware git would
solve such a problem, but being able to jump onto a random machine and
grab all my scripts via the web in a standardised way is pretty nice
too.</p>
<h3>Quicker Searching:</h3>
<p>A simple fix, essentially I added my OSQA search as a keyword search on
my browser so I can quick search by keyword followed by my search term.</p>
<h3>Future Improvements:</h3>
<ul>
<li>In <a href="http://www.amazon.com/Pragmatic-Thinking-Learning-Refactor-Programmers/dp/1934356050">Refactor Your Wetware</a> one of the recommendations the book gives is to use an Engineer's Log, this is essentially what this OSQA install is, my Engineer's Log. One suggestion the book does it mark an X, every-time you use a solution from your Engineers Log. I want to eventually hack OSQA, so that I can use the Upvote feature myself to flag frequently used solutions.</li>
<li>Eventually I'll add pygments syntax highlighting. 4 years later and I still haven't gotten round to it.</li>
<li>I should probably migrate from an OSQA install to Askbot, considering there doesn't seem to be much of an open source future but my current solution works just fine so I see no need.</li>
</ul>
<p>That's about it really, to be honest the lesson here really is that
flexible solutions last.</p>
  </div>
  <div class="tag-cloud">
    <p>
    </p>
  </div>


</article>

<footer>
<p>&copy;  </p>
<p>
Built with <a href="http://getpelican.com" target="_blank">Pelican</a> using <a href="http://bit.ly/flex-pelican" target="_blank">Flex</a> theme
</p></footer>  </main>

<script type="application/ld+json">
{
  "@context" : "http://schema.org",
  "@type" : "Blog",
  "name": " Shane Dowling ",
  "url" : ".",
  "image": "/images/logo.png",
  "description": ""
}
</script>
</body>
</html>