-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathdoc-mgmt.html
More file actions
192 lines (177 loc) · 7.2 KB
/
doc-mgmt.html
File metadata and controls
192 lines (177 loc) · 7.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
<!DOCTYPE HTML>
<html>
<head>
<title>Document Management</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no" />
<link rel="stylesheet" href="assets/css/main.css" />
</head>
<body class="subpage">
<div id="page-wrapper">
<!-- Header -->
<section id="header">
<div class="container">
<div class="row">
<div class="col-12">
<!-- Logo -->
<h1><a href="index.html" id="logo">Document Management</a></h1>
<!-- Nav -->
<nav id="nav">
<a href="index.html">Homepage</a>
<a href="https://101101.github.io">My work with 101101</a>
<a href="about.html">About</a>
<a href="resume.html">Resume</a>
</nav>
</div>
</div>
</div>
</section>
<!-- Content -->
<section id="content">
<div class="container">
<div class="row">
<div class="col-12 col-12-medium">
<!-- Main Content -->
<section>
<header>
<h2>Problem:</h2>
<h3>Enable migration out of the current Document Management solution, if it makes sense from a fiscal and labor perspective - </h3>
</header>
<div class="row">
<div class="col-8 col-12-medium">
<p>
<h3>Description: </h3>
The document management solution that we had was "big," it cost a lot of money, and we didn't have a need to leverage more than ~40% of its capability. We often found ourselves questioning why we continued to use it... Oh yeah, we were "locked in."
</p>
<p>
We wanted to find a solution which <u>cost less</u>, was fairly <u>simple to use</u>, had <u>version control</u>, <u>integrated</u> with our existing systems, and could be used for runbooks and other knowledge articles in response to alerts from our monitoring systems; bonus points if it was able to be <u>directly linked</u> from alerts or notifications.
</p>
</div>
<div class="col-3 col-12-medium">
<h3>Check it out:</h3>
<a href="https://101101.github.io/kb" class="bordered-feature-image"><img src="images/101101.jpg" style="height:100px;width:250px;" alt="Demo" /></a>
<!-- <a href="https://101101.github.io/kb">Check-out the pilot site</a>
-->
</div>
</div>
<hr>
<p>
<h3>What did I do? </h3>
I looked at several other document management systems, and while nearly all of them were cheaper, they all still required more complexity than I thought we needed to achieve the goal.
</p>
<p>
Then I started thinking... GitHub has version control, it's accessible via API, you can run queries against it, and the only different in document formatting was a move to Markdown, which most of us were already embracing with code documentation. And the best part? It's a solution we're already paying for... so, it was essentially "free."
</p>
<p>
So, I searched a bit for a snazzy front-end to put on it (<a href="https://github.com/vsoch/docsy-jekyll">docsy-jeckyll</a>), modified the backend code to fit our document structure, and setup a pilot.
</p>
<hr>
<p>
<h3>What was the outcome? </h3>
The pilot was an immense success!
<ol>
<li>- We were able to send alerts with a multitude of "tags" that would perform searches for runbooks</li>
<li>- The cost was $0 and the savings of not renewing our other document solution was tens of thousands</li>
<li>- It was simple to use, since we already used Markdown</li>
<li>- It is version controlled and can easily leverage workflows</li>
<li>- We can easily integrate it with other solutions since it lives in GitHub </li>
</ol>
</p>
<hr>
<!--
<p>
<h3>What are the benefits? </h3>
<ol>
<li>- placeholder words</li>
<li>- for my template</li>
</ol>
</p>
<hr>
-->
<p>
<h3>Any lessons learned? </h3>
Sometimes the simplest answers are the best ones.
</p>
</section>
</div>
<div class="col-3 col-12-medium">
<!-- Sidebar -->
<!--
<section>
<header>
<h2>Ipsum Dolor</h2>
</header>
<p>
Vehicula fermentum ligula at pretium. Suspendisse semper iaculis eros, eu aliquam
iaculis. Phasellus ultrices diam sit amet orci lacinia sed consequat.
</p>
<ul class="link-list">
<li><a href="#">Sed dolore viverra</a></li>
<li><a href="#">Ligula non varius</a></li>
<li><a href="#">Dis parturient montes</a></li>
<li><a href="#">Nascetur ridiculus</a></li>
</ul>
</section>
-->
</div>
</div>
</div>
</section>
<!-- Footer -->
<section id="footer">
<div class="container">
<div class="row">
<div class="col-12 col-12-medium" align="center">
<!-- Links -->
<section>
<h2>Links:</h2>
<div align="center">
<div class="row">
<div class="col-3 col-12-small">
<ol class="link-list last-child">
<li></li>
<li><a href="https://github.com/dsmith73" class="icon brands style2 fa-github"><span class="label">GitHub</span></a></li>
<li></li>
</ol>
</div>
<div class="col-3 col-12-small">
<ol class="link-list last-child">
<li></li>
<li><a href="https://www.linkedin.com/in/dsmith73" class="icon brands style2 fa-linkedin"><span class="label">LinkedIn</span></a></li>
<li></li>
</ol>
</div>
<div class="col-3 col-12-small">
<ol class="link-list last-child">
<li></li>
<li><a href="https://gitlab.com/dsmith73" class="icon brands style2 fa-gitlab"><span class="label">GitLab</span></a></li>
<li></li>
</ol>
</div>
<div class="col-3 col-12-small">
<ol class="link-list last-child">
<li></li>
<li><a href="mailto:dsmith73@gmail.com" class="icon solid style2 fa-envelope"><span class="label">Email</span></a></li>
<li></li>
</ol>
</div>
</div>
</div>
</section>
</div>
</div>
</div>
<!-- Copyright -->
<div id="copyright">
© dsmith73 - All rights reserved. | Design: <a href="http://html5up.net">HTML5 UP</a>
</div>
</section>
</div>
<!-- Scripts -->
<script src="assets/js/jquery.min.js"></script>
<script src="assets/js/browser.min.js"></script>
<script src="assets/js/breakpoints.min.js"></script>
<script src="assets/js/util.js"></script>
<script src="assets/js/main.js"></script>
</body>
</html>