How the Website is Organized

I spent a considerable amount of time deciding how to organize the content on this website. Then, I spent more time deciding how to present that content to you, the reader. While I hope much of this is self-explanatory, it is very much in my nature write some instructions about it. Be sure to read about the ratings half way down.

And look for Easter Eggs!

High level overview

I arranged the content into high-level topics, like "Digital Technology Guides" ("Guides" for short). The high level topics have sub-topics, such as "Home Technology". The sub-topics are often broken down into series of articles I call "Genius Series", such as "Be a Genius at Wi-Fi". The real stuff is in the articles. Some articles will be one-offs (not part of a series), but I intend for most content to be organized into series.

So. High-level topic -> Sub-topic -> Series -> Article. Got it? Good!

More detail on each below.

Top-Level Topics and Sub-Topics

The menu at the top of each page lists the top-level topics, such as Guides, Career Stuff, and others. You can find a brief description of each of these on the website's main page and a full description on each home page for the topic.

The topic pages have a "TOPICS TO CHOOSE FROM" section with a list of the sub-topics.

Sub-topic pages have a list of all articles in that sub-topic. In these early days of the website, the individual series are not shown. Yet. The articles in a sub-topic are just in "LATEST ARTICLES" order with the newest articles shown first. When I have enough articles in a series, I will do extra work to add the series with its own "card" on the sub-topic page.

Content is organized as articles

Each topic, sub-topic and series has its own landing page. All content articles use the same format, which has lots of cool info packed in to the header.

The cool info packed into the header of each articles!

The website will soon be full of content. You can pick your name for them: articles, posts, pages, bloglets (note to self: register that name), whatever you like. On this website, I call them articles.

What's important is that there's a lot of info in the top section with the slightly darker background. That's called the header of the articles. I'll throw a screenshot of an article in progress on my white board with some notes about what you can find there:

What all that stuff means on the top of each articles

Articles are rated!

Each article has a ratings section. There are three "groups" of ratings. The first is the technical level. Every article will have a technical level.

The second rating won't always be visible. This is the language level, meaning how much cursing/cussing/bad language I used when writing the article. In all honestly, I probably cussed while writing every single one, but this reflects how much I put into writing.

The last group has one or more icons indicating the target audience. There should be no more than 4-5 on a single article, and some articles may just have one.

Ratings Help

If you need a quick reference to the meaning of the different rating icons, use the ? button.

For a longer description of them all, keep reading this page.

Technical Level ratings

The technical level rating icon is a mock Wi-Fi signal indicator with color coded bands. These colors will be seen later in the target audience icons and explained further in that section (below).

Icon Description
tech-level-1.png Technical level 1: high level / plain language used, no specialized technical background required
tech-level-2.png Technical level 2: high level but some technology terms used with the assumption of a moderate technical background. This would be expected of anyone working with a focus on computer software as a profession, such as business analysts or technical recruiters.
tech-level-3.png Technical level 3: lower level working knowledge assumed. Technical terms will be used with brief definitions for terms that are less common. The target audience is typically in a supporting role for software creators, such as QA engineers or technical support staff.
tech-level-4.png Technical level 4: former hands-on technical experience assumed. Managers and other leaders in a technology company should be comfortable with articles marked level 4.
tech-level-5.png Technical level 5: current hands-on technical experience assumed. These articles are for active software creators such as software engineers.

Language Level ratings

Icon Description
No symbol between the technical rating and the audience? No bad language!
cussing-level-1.png Level 1: Occasional mild cussing. Probably safe for anyone with access to the Internet
cussing-level-2.png Level 2: Level 1 just more of it
cussing-level-3.png Level 3: Probably some F bombs
cussing-level-4.png Level 4: Lots of F bombs

Target Audience

The icons in thes table are links that will take you to articles written for that audience.

Icon Description
aud-everyone.png This article is for Everyone (EV), whether you work professionally with technology or just use technology in your personal life.
aud-human-resources.png This article is for Human Resources (HR) or similar roles in any company employing technical professionals. You will be more effective in understanding the roles in your organization if you understand the technology essentials relating to those roles.
aud-customer-service.png This article is for Customer Service (CS). Sometimes, you are the last to know about a product you will bu supporting. Any universally useful information that will help make your job easier will be shared here.
aud-product-developers.png This article is for Product Developers (PD). Product Developers is an audience category that includes Business Analysts (BA), Product Owners (PO) and Project Managers (PM). These are the roles involved before a software project has begun. Articles that apply to this category as a whole will be rated with this tag.
aud-business-analysts.png This article is for Business Analysts (BA). You likely hear technical discussions and jargon from software creators or supporters on your team. I help you make sense of it all so you can be more effective.
aud-product-owners.png This article is for Product Owners (PO), who often do not have a technical background. Sometimes you need a better understanding of some core concepts to make sense of time estimates for work that the software creators will give you. Sometimes you just need to understand if a request is simple or if you are asking the team to move the building 1 foot to the left.
aud-project-managers.png This article is for Project Managers (PM). You can make more sense of time estimates or unexpected delays if you have a solid understanding of what the software creators are facing.
aud-tech-recruiters.png This article is for Technical Recruiters (TR). You don't often come from a technical background, and hiring managers aren't always good at articulating their requirements for new candidates. The technical landscape also changes fast, so what you knew last year may no longer be relavent. The more you know, the better you can be at finding the right candidates.
aud-software-supporters.png This article is for Software Supporters (SS). Software Supporters is an audience category that includes Tech Support (TS), QA Engineers (QA), and Dev Ops (DO). These are the roles that support the software creators by testing, supporting, deploying and maintaining production systems. While these roles may not be hands-on with the software creation process, they are critical to ensuring quality, stability and performance.
aud-tech-support.png This article is for Tech Support (TS). You are often the front line support for a software product or system, but you were probably not involved in the creation or decisions made when creating those products or systems. The more you know about the underlying technology of the products you support, the more effective you will be.
aud-qa-engineers.png This article is for Quality Assurance Engineers (QA). You are expected to test software for quality, but you are not always given the technical details of the thing you are testing. Or, maybe not in terms you can understand. The more you know, the more effective you will be.
aud-dev-ops.png This article is for Dev Ops (DO). You are a special category of Software Supporter, in that you are expected to have a deeper understanding of the technologies used by the Software Creators. This is why your icon is color-coded red to match technical level 5.
aud-managers.png This article is for Managers of Software Creators or Software Supporters (MG). This is an audience category that may include sub-categories such as Hiring Managers or Software Engineering Managers in the future. While you are no longer active producers, you will be expected to understand the technical concepts in the article. This is why your icon is color-coded orange to match technical level 4.
aud-leadership.png This article is for Executive Leadership (EL) with Software Creators or Software Supporters in their reporting structure. This is an audience category that may include sub-categories such as Directors, Vice Presidents or Corporate Officers. You need to have a strong foundation in the technologies used by your direct reports in a company that produces software products or services. While you are no longer active producers, you will be expected to understand the technical concepts in the articlepost. This is why your icon is color-coded orange to match technical level 4.
aud-software-creators.png This article is for Software Creators (SC). This is an audience category that includes Software Engineer (SE), Software Architect (SA) and Staff Engineer (ST).
aud-software-engineer.png This article is for Software Engineers (SE). Software Engineers have many different focuses (full stack, front-end, back-end, mobile, etc). This applies to Software Engineers as a whole.
aud-software-architect.png This article is for Software Architects (SA). Software Architects have many different focuses (enterprise architect, application architect, data architect, etc). This applies to Software Architects as a whole.
aud-staff-engineer.png This article is for Staff Engineers (ST). This is a special category of Software Creator that has been seen in larger Silicon Valley companies. If you know you are a Staff Engineer, this articlepost is for you. If you aren't sure, read more here (article coming soon). The Staff Engineer icon is solid red, unlike the other technical level 5 roles, to highlight the expectations and capabilities of people filling this role.

The trail of breadcrumbs such as "Guides > Home Technology > Wi-Fi Genius Series" tells you "where you are" on the website. These are all links, so you can click/tap them to see other "Home Technology" articles, or the "Guides" home page.

Title, Excerpt, and the rest

The rest is self-explanatory, and I won't bore you with details.

However, the estimated reading time is based on an algorithm that is not my own, purely based on the number of words on the page. Please use that as a a suggestion of how long it will take to read. Everyone's mileage may vary.

Genius Series

Many topics will be organized into a series in a format that I call a Genius Series, such as "Be a Genius at Wi-Fi". These will sometimes have numbers in the title, indicating the order to read them.

When reading an article that is part of a series, at the end of the article you will see a "Start Here" section with a link taking you to the home page for that series as well as a "Continue" section with the next articles in the series. Any time you are reading an article that is part of a series, you can find the start of the series at the bottom of the page, next to a fancy "Start here" graphic.

That's all, for now, on how to navigate your way through the website. More features are coming soon!

Updates

  • 2024-08-05: Changed "post" to "article"
  • 2024-08-23: Updated wording
Subscribe!