This document set describes how to build a Personal Information Managment (PIM) system as discussed in the related of the blog post A Personal Information Management System: Introducing Scrapbook. In that post we describe why we built our own PIM system and we take a high-level look at how it was built. We call our PIM system "Scrapbook". This web site discusses in detail how you can create a version of Scrapbook yourself on Windows using the .NET Framework or .NET Core. In the interest of reduced complexity, we present here a simplified version we call Scrapbook101core.
After building and running the code, you should have a simple Scrapbook101core site populated with test entries and supporting assets. These document pages are still a work in progress. The footer of each page contains the last doc build date.
This document set covers both Scrapbook101core implemented on the .NET Framework and .NET core, with an emphasis on the latter.
Okay, where's the code? It's in the GitHub repository: https://github.com/travelmarx/scrapbook101core.
A brief recap
The blog post referenced above discusses our reasons for creating a Scrapbook application. To summarize, in our PIM we wanted to:
- Deal with ever-increasing amounts of personal archival data, both physical and digital, in a consistent way.
- Capture context about data so that when we referred to our data int the future we would understood why we saved it and why it was important.
- Find our data quickly and on-demand, for example, using natural language or a chat bot.
- Own our data and not have it live in a social network or service that locks the format or controls our access to it.
The way we could accomplish this was to create a custom PIM system consisting of software, programming frameworks, and cloud services working together to achieve the four principles described above.
While Scrapbook101core is a pared-down version of what we described in the blog post, it has enough of the basic functionality to be a good starting point for someone interested in creating their own Scrapbook.
Why this site?
Why is Scrapbook101core documented here and not on blog.travelmarx.com? For two reasons. First, we were interested in trying out DocFx for technical documentation. And second, demonstrating code and talking about it in a Blogger post is not easy for a writer or reader. Hence, this DocFx site was born.
Creating this site was an odyssey into new tools and practices that we thought were interesting to document as well. If you want to know a little bit about how this site was created, see About This Site.