Skip to content

Commit ebb3442

Browse files
committed
Deployed a411a02 with MkDocs version: 1.6.1
1 parent 9bb8270 commit ebb3442

File tree

17 files changed

+79
-79
lines changed

17 files changed

+79
-79
lines changed
24 Bytes
Loading
-4.76 KB
Loading

blog/2023/08/25/the-history-of-asbuiltreport/index.html

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727

2828

2929

30-
<title>The history of As Built Report - AsBuiltReport</title>
30+
<title>The history of AsBuiltReport - AsBuiltReport</title>
3131

3232

3333

@@ -74,7 +74,7 @@
7474

7575
<meta property="og:type" content="website" >
7676

77-
<meta property="og:title" content="The history of As Built Report - AsBuiltReport" >
77+
<meta property="og:title" content="The history of AsBuiltReport - AsBuiltReport" >
7878

7979
<meta property="og:description" content="Document Your Datacenter With PowerShell" >
8080

@@ -90,7 +90,7 @@
9090

9191
<meta name="twitter:card" content="summary_large_image" >
9292

93-
<meta name="twitter:title" content="The history of As Built Report - AsBuiltReport" >
93+
<meta name="twitter:title" content="The history of AsBuiltReport - AsBuiltReport" >
9494

9595
<meta name="twitter:description" content="Document Your Datacenter With PowerShell" >
9696

@@ -115,7 +115,7 @@
115115
<div data-md-component="skip">
116116

117117

118-
<a href="#the-history-of-as-built-report" class="md-skip">
118+
<a href="#the-history-of-asbuiltreport" class="md-skip">
119119
Skip to content
120120
</a>
121121

@@ -150,7 +150,7 @@
150150
<div class="md-header__topic" data-md-component="header-topic">
151151
<span class="md-ellipsis">
152152

153-
The history of As Built Report
153+
The history of AsBuiltReport
154154

155155
</span>
156156
</div>
@@ -2384,9 +2384,9 @@
23842384
</li>
23852385

23862386
<li class="md-nav__item">
2387-
<a href="#as-built-report-was-born" class="md-nav__link">
2387+
<a href="#asbuiltreport-was-born" class="md-nav__link">
23882388
<span class="md-ellipsis">
2389-
As Built Report was born!
2389+
AsBuiltReport was born!
23902390
</span>
23912391
</a>
23922392

@@ -2512,27 +2512,27 @@
25122512

25132513

25142514

2515-
<h1 id="the-history-of-as-built-report">The history of As Built Report</h1>
2515+
<h1 id="the-history-of-asbuiltreport">The history of AsBuiltReport</h1>
25162516
<h2 id="the-beginning">The Beginning</h2>
25172517
<p>Back in 2017, having worked on designing and implementing VMware solutions for almost a decade, I became frustrated with having to repeatedly produce as-built documentation for my virtualisation projects.</p>
25182518
<p>At the time, I was designing and implementing 2-3 VMware solutions per month. Each solution would be designed using numerous technology partners, each with their own range of compute, storage, networking and backup technologies.</p>
25192519
<p>My methods to create as-built documentation was arduous, time consuming and error prone. It often involved extracting information using a combination of vendor supplied tools and community developed scripts, and manually transposing information from the vCenter console into a Word document. It was tedious and often resulted in a poorly constructed and formatted document.</p>
25202520
<p>It was also around this time that I realised I had a strong desire to learn PowerShell after seeing many of my co-workers starting to write scripts to automate simple, repeatable tasks. Until this moment, I had never taken the time to completely understand the fundamentals of PowerShell, nor had I worked to develop and expand my knowledge in any form of scripting or automation.</p>
2521-
<p>As a result, I saw this as an opportunity to learn and employ PowerShell automation to ease my pain and frustrations with producing as-built documentation. And so began my mission to create As Built Report!</p>
2521+
<p>As a result, I saw this as an opportunity to learn and employ PowerShell automation to ease my pain and frustrations with producing as-built documentation. And so began my mission to create AsBuiltReport!</p>
25222522
<!-- more -->
2523-
<h2 id="as-built-report-was-born">As Built Report was born!</h2>
2524-
<p>As Built Report began as a single PowerShell script to capture information from VMware vSphere environments, however I quickly realised that my need to produce as-built documentation needed to extend beyond just VMware, and required the ability to capture information from a wide range of vendors and technologies.</p>
2525-
<p>After developing the basic concepts of gathering information from VMware vSphere using PowerCLI, I was left without a mechanism to present and output the information in an acceptable document format. Had it not been for a colleague telling me about <a href="../../../../../support/faq/#what-is-pscribo">PScribo</a>, I doubt As Built Report would have ever seen the light of day.</p>
2523+
<h2 id="asbuiltreport-was-born">AsBuiltReport was born!</h2>
2524+
<p>AsBuiltReport began as a single PowerShell script to capture information from VMware vSphere environments, however I quickly realised that my need to produce as-built documentation needed to extend beyond just VMware, and required the ability to capture information from a wide range of vendors and technologies.</p>
2525+
<p>After developing the basic concepts of gathering information from VMware vSphere using PowerCLI, I was left without a mechanism to present and output the information in an acceptable document format. Had it not been for a colleague telling me about <a href="../../../../../support/faq/#what-is-pscribo">PScribo</a>, I doubt AsBuiltReport would have ever seen the light of day.</p>
25262526
<p>PScribo was the solution I had long been searching for. Not only did it provide the capabilities to export information into Word, HTML and Text formats, it was also extremely simple to grasp and implement. I now had all the pieces to the puzzle!</p>
25272527
<p>In March 2018, I delivered my first ever <a href="https://speakerdeck.com/tpcarman/vmug-usercon-2018-documenting-your-virtual-infrastructure-with-powershell-and-powercli" target="_blank">presentation</a> at the Melbourne VMUG User Conference, to showcase my initial work on the VMware vSphere as-built script. My presentation, despite its terrible delivery, was warmly welcomed by the local audience, giving me the confidence and motivation I needed to keep working on the script.</p>
2528-
<p>As Built Report had taken months of my personal effort to produce by this point. I understood then, as I had known from the start, that it would be impossible for me to continue developing the project on my own. Having benefited so much from VMware's community contributions, I saw this as my opportunity to give back to the vCommunity by sharing what I had created, and allowing others to develop their own reports.</p>
2528+
<p>AsBuiltReport had taken months of my personal effort to produce by this point. I understood then, as I had known from the start, that it would be impossible for me to continue developing the project on my own. Having benefited so much from VMware's community contributions, I saw this as my opportunity to give back to the vCommunity by sharing what I had created, and allowing others to develop their own reports.</p>
25292529
<h2 id="vmworld-us-2018">VMworld US 2018</h2>
25302530
<p>In August 2018, <a href="../../../../../about/contributors/#matt-allford">Matt Allford</a> and I presented <a href="https://www.youtube.com/watch?v=aQqHSEIUHl8" target="_blank">'Documenting Your Virtual Infrastructure with PowerShell and PowerCLI'</a> to a worldwide audience of 500+ people at VMworld in Las Vegas. Our session would go on to be the highest viewed session for the entire VMworld US conference. The word was out and the excitement began to grow.</p>
25312531
<p><img alt="VMworld 2018" loading="lazy" src="../../../../../assets/images/blog/VMworld-2018.jpg" /></p>
25322532
<center><iframe width="600" height="400" src="https://www.youtube.com/embed/aQqHSEIUHl8?si=0gfNzm7rN5fujvhl" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></center>
25332533

25342534
<h2 id="the-evolution">The Evolution</h2>
2535-
<p>Soon after VMworld, we began work on redesigning the core architecture of As Built Report to make it more modular to support different report modules. This eventually evolved into the As Built Report framework and the <a href="https://www.powershellgallery.com/packages/AsBuiltReport.Core/" target="_blank">AsBuiltReport.Core module</a>. With the core framework now in place, I worked on refactoring the VMware vSphere script and developing some other report modules.</p>
2535+
<p>Soon after VMworld, we began work on redesigning the core architecture of AsBuiltReport to make it more modular to support different report modules. This eventually evolved into the AsBuiltReport framework and the <a href="https://www.powershellgallery.com/packages/AsBuiltReport.Core/" target="_blank">AsBuiltReport.Core module</a>. With the core framework now in place, I worked on refactoring the VMware vSphere script and developing some other report modules.</p>
25362536
<p>Since then, the project has been open-sourced and has continued to grow, with code published to our <a href="https://github.com/AsBuiltReport" target="_blank">GitHub repository</a> and modules released to the <a href="https://www.powershellgallery.com/packages?q=AsBuiltReport*" target="_blank">PowerShell Gallery</a>.</p>
25372537
<p>And thanks to contributions from <a href="../../../../../about/contributors/#jonathan-colon">Jonathan Colon</a>, <a href="https://github.com/mwpreston" target="_blank">Mike Preston</a>, <a href="https://github.com/alagoutte" target="_blank">Alexis La Goutte</a>, <a href="https://github.com/childebrandt42" target="_blank">Chris Hildebrandt</a> and <a href="../../../../../about/contributors/#other-contributors">others</a> we have now expanded our <a href="../../../../../user-guide/report-modules/overview/">range of report modules</a>, with many more in development!</p>
25382538

@@ -2598,13 +2598,13 @@ <h2 id="the-evolution">The Evolution</h2>
25982598

25992599

26002600

2601-
<a href="../../../12/05/The-future-of-As-Built-Report/" class="md-footer__link md-footer__link--next" aria-label="Next: The future of As Built Report">
2601+
<a href="../../../12/05/The-future-of-As-Built-Report/" class="md-footer__link md-footer__link--next" aria-label="Next: The future of AsBuiltReport">
26022602
<div class="md-footer__title">
26032603
<span class="md-footer__direction">
26042604
Next
26052605
</span>
26062606
<div class="md-ellipsis">
2607-
The future of As Built Report
2607+
The future of AsBuiltReport
26082608
</div>
26092609
</div>
26102610
<div class="md-footer__button md-icon">

blog/2023/12/05/The-future-of-As-Built-Report/index.html

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929

3030

3131

32-
<title>The future of As Built Report - AsBuiltReport</title>
32+
<title>The future of AsBuiltReport - AsBuiltReport</title>
3333

3434

3535

@@ -76,7 +76,7 @@
7676

7777
<meta property="og:type" content="website" >
7878

79-
<meta property="og:title" content="The future of As Built Report - AsBuiltReport" >
79+
<meta property="og:title" content="The future of AsBuiltReport - AsBuiltReport" >
8080

8181
<meta property="og:description" content="Document Your Datacenter With PowerShell" >
8282

@@ -92,7 +92,7 @@
9292

9393
<meta name="twitter:card" content="summary_large_image" >
9494

95-
<meta name="twitter:title" content="The future of As Built Report - AsBuiltReport" >
95+
<meta name="twitter:title" content="The future of AsBuiltReport - AsBuiltReport" >
9696

9797
<meta name="twitter:description" content="Document Your Datacenter With PowerShell" >
9898

@@ -117,7 +117,7 @@
117117
<div data-md-component="skip">
118118

119119

120-
<a href="#the-future-of-as-built-report" class="md-skip">
120+
<a href="#the-future-of-asbuiltreport" class="md-skip">
121121
Skip to content
122122
</a>
123123

@@ -152,7 +152,7 @@
152152
<div class="md-header__topic" data-md-component="header-topic">
153153
<span class="md-ellipsis">
154154

155-
The future of As Built Report
155+
The future of AsBuiltReport
156156

157157
</span>
158158
</div>
@@ -2574,18 +2574,18 @@
25742574

25752575

25762576

2577-
<h1 id="the-future-of-as-built-report">The future of As Built Report</h1>
2578-
<p>In my <a href="../../../08/25/the-history-of-asbuiltreport/">previous post</a> I shared how I came to start As Built Report and my reasons for doing so. It's been a few years since its inception and some of you may be asking what does the future hold for the project?</p>
2577+
<h1 id="the-future-of-asbuiltreport">The future of AsBuiltReport</h1>
2578+
<p>In my <a href="../../../08/25/the-history-of-asbuiltreport/">previous post</a> I shared how I came to start AsBuiltReport and my reasons for doing so. It's been a few years since its inception and some of you may be asking what does the future hold for the project?</p>
25792579
<p>Before I delve into what may lie ahead, let me take a moment to reflect on the project's progression so far, by extending a sincere thank you to all the <a href="../../../../../about/contributors/">contributors</a> who have given their time and effort to this project. Whether you have contributed code, reported bugs, provided feedback, written a blog post, or simply participated in discussions, your efforts have not gone unnoticed.</p>
25802580
<!-- more -->
25812581

25822582
<h2 id="a-special-thanks-to-jon">A special thanks to Jon!</h2>
25832583
<p>I'd also like to give a special thanks to <a href="../../../../../about/contributors/#jonathan-colon">Jonathan Colon</a> for his ongoing contributions to this project. His code contributions have not only significantly expanded and improved the report library, but his ongoing dedication has undoubtedly kept this project alive! I am grateful for his dedication to the project; from bug fixes to feature enhancements, his contributions have been critical in the project's development and has kept it moving forward.</p>
25842584
<h2 id="my-challenges">My challenges</h2>
2585-
<p>While I am extremely grateful for the contributions to As Built Report, I must also be open and honest about some of the current challenges I am facing with the project and how these may impact its future.</p>
2585+
<p>While I am extremely grateful for the contributions to AsBuiltReport, I must also be open and honest about some of the current challenges I am facing with the project and how these may impact its future.</p>
25862586
<p>As we all know, life can be hectic, and we all have our own set of priorities. As I sit here in isolation, suffering from the effects for COVID, it's clear that this project is no longer high on my priority list. After experiencing two years of the world's most severe lockdowns here in Melbourne, I realised that spending long periods of time in front of a computer screen, constantly thinking about work, was negatively impacting my mental health. I had no discipline in switching off from any of this. I became exhausted and burnt out!</p>
25872587
<p>Since the end of lockdown, most of us have changed our working habits and work-life balance in some way, whether it's working from home, limiting our screen time, or getting out and about more frequently. I continue to work on incorporating all of these into my daily routine, but the one I'm most strict about is spending less time in front of my computer. While I have always put my family first, I cannot say the same for my health. Changes need to be made.</p>
2588-
<p>When I first started As Built Report, I was working with a wide range of IT infrastructure on a daily basis and would often have the time and access to develop many of the reports you use today. However this is no longer the case, as I have taken on a new job role earlier this year and am now solely focused on Azure-related projects. As a result, I no longer have the time or access to this infrastructure to keep many of these reports up to date.</p>
2588+
<p>When I first started AsBuiltReport, I was working with a wide range of IT infrastructure on a daily basis and would often have the time and access to develop many of the reports you use today. However this is no longer the case, as I have taken on a new job role earlier this year and am now solely focused on Azure-related projects. As a result, I no longer have the time or access to this infrastructure to keep many of these reports up to date.</p>
25892589
<p>So herein lies the challenge! Without access to the IT infrastructure and with less time in my daily schedule, <strong>I can no longer maintain this project and will need more help from you</strong>, the users, to keep this project alive and relevant!</p>
25902590
<p>I created and shared this project in response to the overwhelming positive feedback I received following my <a href="https://www.youtube.com/watch?v=aQqHSEIUHl8" target="_blank">VMworld presentation</a> in 2018. Following my presentation, many people apporached me and asked how they could get involved. I didn't have any set expectations at the time, and I've always wanted this tool to be freely available for everyone to use, but in the past few years, I've noticed that most users expect myself or Jonathan to develop or fix reports, rather than exploring ways to develop or fix a report themselves. While I am grateful for those who have contributed thus far, I continue to believe that there is still a large amount of untapped potential within our user base that could elevate the project further.</p>
25912591
<h2 id="but-what-does-this-all-mean">But... what does this all mean?</h2>
@@ -2604,7 +2604,7 @@ <h3 id="feature-requests"><span class="twemoji"><svg xmlns="http://www.w3.org/20
26042604
<h3 id="spread-the-word"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 17V7H4v10zm0-14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2zm5.5 0h5A1.5 1.5 0 0 1 23 4.5v3A1.5 1.5 0 0 1 21.5 9H18l-3 3V4.5A1.5 1.5 0 0 1 16.5 3"/></svg></span> Spread the Word</h3>
26052605
<p>Help expand our community by sharing your positive experiences with this project. Whether through social media, blog posts, or word of mouth, your advocacy contributes to the project's growth.</p>
26062606
<h2 id="a-final-thanks">A final thanks!</h2>
2607-
<p>In closing, I'd like to again thank all of the awesome <a href="../../../../../about/contributors/#other-contributors">people who have contributed</a> to this project. Your help and contributions are invaluable, and I look forward to welcoming more contributors in the future who are willing to donate their time and energy to developing and expanding the As Built Report project.</p>
2607+
<p>In closing, I'd like to again thank all of the awesome <a href="../../../../../about/contributors/#other-contributors">people who have contributed</a> to this project. Your help and contributions are invaluable, and I look forward to welcoming more contributors in the future who are willing to donate their time and energy to developing and expanding the AsBuiltReport project.</p>
26082608

26092609

26102610

@@ -2667,7 +2667,7 @@ <h2 id="a-final-thanks">A final thanks!</h2>
26672667
<nav class="md-footer__inner md-grid" aria-label="Footer" >
26682668

26692669

2670-
<a href="../../../08/25/the-history-of-asbuiltreport/" class="md-footer__link md-footer__link--prev" aria-label="Previous: The history of As Built Report">
2670+
<a href="../../../08/25/the-history-of-asbuiltreport/" class="md-footer__link md-footer__link--prev" aria-label="Previous: The history of AsBuiltReport">
26712671
<div class="md-footer__button md-icon">
26722672

26732673
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
@@ -2677,7 +2677,7 @@ <h2 id="a-final-thanks">A final thanks!</h2>
26772677
Previous
26782678
</span>
26792679
<div class="md-ellipsis">
2680-
The history of As Built Report
2680+
The history of AsBuiltReport
26812681
</div>
26822682
</div>
26832683
</a>

0 commit comments

Comments
 (0)