Skip to main content

· 2 min read
John M Telford
caution

Work in Progress - Blog v 0.3.1 - Apr 3, 2022


Contact Information


Welcome

This blog is the latest of many John Telford blog and website reincarnations over the years.

Way back when the internet was young, while researching I discovered blog and website site generator technologies, that seemed to bring something new to the party .

I sometimes do learn by doing, by taking deep technology dives by programming the next blog or website reincarnations using the technology du jour.

This blog is about some interesting things found.


note

The quickest way to search blog posts is to click Topics

caution

These features are not available on small screens

⬅️ The left is a list of blog posts. Click one to display it. ➡️ Click an index of the selected blog post

↖️ Click Topics for blog post with tags.

⬇️ Scroll down to view blog posts. Blog post tags are at the end of a post. Click a tag for all blog posts with that tag


· One min read
John M Telford

· One min read
John M Telford

I am the sole proprietor of JohnTelford.com LLC. It is a technology consulting company working with client development projects for more that 30 years.

Nuggets

Way back when the Internet web browsers and programming languages came along, I became interested in web technologies, and began learn by doing technology deep dives. I have years of learning ever changing Electronics, Internet, and Software technologies by hands-on experiencing the technologies du jour.

I have a passion pursuing what’s new and improved with these industries. Checking out what’s new or not, a pipe dream or not, or what’s new and improved, is like panning for gold. Buried within the mountains of info rubble produced daily, every so often one finds interesting technology nuggets making the effort worthwhile. I use the Hype Curve as a guide.

I am an Electronics, Software, and Web Engineer specializing in website hardware and software technology disciplines:

  • Architecture
  • Development
  • Deployment

Contact

A labyrinth symbolizes possible difficulties reaching website project goals. Knowledge and experience with web technology disciplines may be helpful.

MugShot

John Telford
Portland, Oregon
JohnTelford.com LLC

phone:text 503-312-7248

Email


· 2 min read
John M Telford

Brochureware

Some websites I create are often brochureware. The website material is text with graphics and links sprinkled in.

I am hesitant creating brochureware websites without using Markdown . It is quicker creating web pages using Markdown than HTML.

· 3 min read
John M Telford

John Telford

The latest incarnation of the John Telford website is built using the mdBook site generator

Tech Talk John

The latest incarnation of the TechTalkJohn Blog is what you are viewing. It is built using the blog components of the Docusaurus site generator.

The Docusaurus site generator has the out-of-the-box features I was looking for, so I reincarnated TechTalkJohn blog websites using it

I chose this site generator because:

  • Docusaurus abstracts React
  • Posts are written use MDX
    • Embedded JSX and HTML
    • MDX is compiled to the troika of HTML, CSS, and JavaScript standard website programming languages
    • The blog sidebar on the left side of the screen displays a list of blog posts
  • The right menu is the selected blog post headers levels
  • Click menu bar Blog Tags for a list of blog post with tags. Click a tag for all blog posts with that tag
  • Multiple tags can be assigned to blog posts
  • Light or dark theme toggle

· 2 min read
John M Telford

Deep Technology Dives

I have been doing deep technology diving exploring website site generators over the years. I have chosen to reincarnate JohnTelford.com website using mdBook and TechTalkJohn blog websites using Docusaurus.


jamstack

Some website site generators I experienced did not have some of the out-of-the-box features I was looking for.

My preference for website site generators are based on Jamstack architecture

Some out-of-the-box missing aributes I was looking for in deep technology dives were:

  • Sidebar Menu
  • Automatic last update date of file
  • File tags
  • An integrated blog
  • JSX embedded Markdown

I found these and more attributes in some of the website site generators listed in Site Generators.


· 6 min read
John M Telford

The Hype Curve helps separate reality from fiction.


Hype Curve

Hype Curve


Points of Interest

The Hype Curve points of interest are:

Technology Trigger

A potential technology breakthrough happens.

Peak of Inflated Expectations

Early publicity produces a number of success stories and often accompanied by stories of failures. Some companies may take corrective action but most don’t.

Trough of Disillusionment

Interest wanes as experiments and implementations fail to deliver on the hype.

Slope of Enlightenment

Technology consumers begin to understand the technology better and how it may benefit them.

Plateau of Productivity

Mainstream adoption starts to take off. Some technologies making it to the Plateau of Productivity may be doomed to the spiral of death by inattention to details of keeping products alive.


· 2 min read
John M Telford

The basic idea of Iterative Development is to develop a system through repeated cycles (iterative) and in smaller portions at a time (incremental), allowing iterative development teams to take advantage of what was learned during development of earlier parts or versions of the system.

Teams

Teams

Iterative Development Teams

ItIterative website development teams working together can help optimizing website costs and lower some the difficulties creating websites

Iterative website development enables the Define, Design, Develop, Deploy and Maintain teams to be operational at the same time creating, testing and remediating website defects

Central Repository

The core of Iterative Development is a file central repository controlled by a gatekeeper.

GitHub is a Distributed Version Control Systems enabling multiple teams to work separately without having an impact on the work of others. GitHub is a central online web hosted project repository for all project files. It is a unified source of truth. It helps teams collaborate and maintain the entire history of project file changes. Teams can view history of all changes and go back to previous file versions.

It helps answer the questions who changed what, where, when, and why?

All team members have their own local copy of the central project repository. They make changes, fix defects, add new features to their repository, without interfering with others team members, or the central repository.

Team members cannot directly make changes to the central repository. They may deploy their copy of the repository with their changes, to a private Internet website for stakeholders to see and give feedback.

When stakeholders determine some changes, defect fixes, or new features are ready, they will be committed to central project repository, and team members update their local copy by pulling central repository changes into their local repository. This process keeps team members up to date.

· One min read

This website is the latest of many JohnTelford.com reincarnations over the years. When I discover a website development framework technology that seems to bring something new to the party, I sometimes do a learn by doing deep technology dive by programming the next ** reincarnation.

· One min read
John M Telford

I have used some of these Site Generators. This is the most complete list I have seen.

This blog was built using Docusaurus site generator.

I have used these site generators:

  • Docusaurus
  • Gatsby
  • GitBook
  • Hugo
  • Jekyll
  • mdBook
  • MkDocs
  • Next.js
  • Sphinx