Code Workshop

repositories, stories, and documentation

About Site Repo
This image
The source for this image is an SVG file generated from a photo of my desktop, using a converter application from Adobe's website .
"Good judgement comes from experience, and experience comes from bad judgement."
- Jim Horning
Jim Fawcett
Hi, I'm Jim Fawcett. I enjoy talking about and developing software. This is my site and I'm glad you stopped by. The site is intended for anyone interested in software development, especially for developers using C++, Rust, or C#. All are welcome.
Disclaimer
I am building this site to learn about things that interest me and provide reference and learning materials for others. Code here is exploratory and/or expository. I make no claims of fitness for production. I think most of what you see here is correct, clearly stated, and follows accepted idioms. The earliest material may not always be so, but I do go back to make improvements. You can help by advising me here of needed improvements. None of the texts or codes displayed in this site have been generated by AI assistants. I do use ChatGPT to discover bits of syntax that are not well documented and to help debug small bits of code, especially for JavaScript that implements much of the user functionality of the site. Also, ChatGPT has proven useful for generating regular expressions and listing all the options for terminal commands.
This site is all about code: Repositories, Stories with examples, Bites that focus on language features, and bits that compare several programming languages. Thanks to Mike Corley for many reviews and suggestions that have helped improve this site.
You are looking at a new version of the first site I built to learn Rust by trying to explain how it works. That had fairly complete content, but was too hard to use and maintain, and some contents needed simpler explanations. This site is simpler to use, but is very much a work in progress with missing links and only has bits and pieces of content. Porting and simplifying material from the first site will happen as quickly as time permits.

1.0 Stories, Bites, Bits, and Repositories:

Figure 1. Stories and Bites
Many of the images and diagrams in this site are expandable. Click on the body to expand, click on the title to contract.
Much of this site's contents are "Stories", "Bites", "Bits" and "Repositories". Each of these are implemented as threads, e.g., a linked list of pages traversed with "Prev", "Next", and "Pages" menu buttons. Stories are narratives about a programming language or other technical topic. Think of threm as ebooks that give a reasonably thorough presentation of topic details in a series of linked pages, one for each chapter.
Rust Story   The Rust Story consists of seven chapters, with each chapter presented on one page. For example, the Models chapter provides an overview of Rust's code structure, process for building, ownership, user-defined types and Traits, and Generics. And provides exercises and references at the end. After studying this chapter you will be able to begin writing useful code with Rust. There are other stories which you can access from the "Stories" dropdown in the top menu, and can also be reached from links in the SiteMap.
A Bite is a single web page focused on one feature of a language or platform. Bites are linked into a thread using Prev and Next links, so the thread covers important parts of its parent story and is easily navigated. Rust Bites Rust Bites divide each story chapter into a few Bites, each focused on an important topic in the chapter, and linked together. For example the Data bite covers operations: bind, copy, borrow, move, clone, and mutate, with conclusions and exercises at the end. Bytes provide more details or a different point of view than the story chapter, so that makes an expanded narrative from easy to digest pieces. There are Bites for most of the Tracks, accessible from the "Tracks" dropdown in the top menu and from the SiteMap. Bits are relatively small compilable codes written in several languages: C++, Rust, C#, Python, and JavaScript. Bits allow you to compare two languages by comparing their code fragments and resulting outputs. Code Bits Bits provide step-by-step instructions for setting up tool chains for building, running, and debugging code in each of the languages. They also provide levels of code examples, for each of the languages, that help you understand the language type systems, user-defined types, and common operations. For example, Bits_DataRust and Bits_DataCpp. Repositories are containers for code and documentation, available from the "Repos" drop-down on the top menu. There are repository collections for C++, Rust, C#, JavaScript, and Other. Each member of a collection is a documentation webpage that links to a github repository containing code.
Rust Repositories The Rust collection contains tools, components, libraries, projects, and demos. For example, the components contain a repository for a thread pool written in Rust. You will find many small C++ and Rust demonstration programs in the "Dems" drop-downs. All of the curated code is available from the "Repos" dropdown in the top menu.
Most repositories have a documentation web page that discusses its code and links to a github repository with the code. Essentially, repositories in this site are proxies for the actual code in a github repository. We've used Rust for these examples because Rust is the only language for which we have all three: Story, Bites, and Repositories. C++ has a story and Repositories. For C# there are only a few repositories. Eventually I expect that all three will have all of these things.
Languages Content
This site focuses on three programming languages: C++, Rust, and C#, with emphesis on the first two. Content tracks are provided, from the top menu, for basic background information, and for each of the three languages. Both C++ and Rust are important systrem programming languages that compile to native code. They give you tools to build quick and reliable systems and user applications. Rust provides reliability with compiler enforcements. C++ does that with conventions and helper types. C# is a managed language, deeply integrated with the dotnet framework and, like C++ and Rust, can run on Windows, Linux, and MacOS. At this time, C# coverage in this site is shallow, consisting of several code repositories. Eventually that will be augmented by a C# Story and Bites.

Table 1. - Language Tracks

Track Content Comments
Basics Platforms, Programming, and Object Models Background information needed to develop code effectively
C++ primitives, functions, classes, relationships, templates Source compiles to native code, good performance, safe by convention using library tools
Rust primitives, mutation, copy, move, structs, generics, safety Compiles to native code, good performance, safe by construction through compiler enforcements
C# primitives, classes, generics, garbage collection Source compiles to bitecode, jitted to native at run-time, memory safe by construction
The tracks provide information suitable for developers, for reference or to start learning about one of these languages. Stories and Bites cover most of the features of C++ and Rust, and materials for C# are being developed too. Discussions are quite complete, but accompanied with diagrams and code examples to make the learning process fairly painless. There are also coding exercises at the end of most story chapters and many of the Bites.

2.0 Purpose:

There are two purposes for building this site: to house and dispense an organized collection of software and to explore techniques for building web sites tuned to software content.

2.1 Migrate teaching code and add newly developed resources

While teaching graduate software design courses at Syracuse University I developed a website containing lectures, solutions for midterm exams, project specifications, and a lot of sample code. SU Site The original SU site organizes material for graduate Computer Engineering courses I taught from 1991 to 2019. It is structured by course and student interests with lots of student pictures. All the course contents: syllabus, lecture content, and assignments are accessible by clicking the "Courses" top menu item. This includes content for: Here are pictures of students from my classes and from my research team: I retired in 2019 and have since been working mostly with the Rust language, but also in C++, with a little Python and C# thrown in. That work is featured in Tracks developed for this new site.

2.2 Experiment with Web Display Techniques

The second purpose is to experiment with ways to present code, diagrams, text discussion, images and charts. All vie for page real estate and what is most important to a user may vary over time. So the site needs to manage size and placement in ways that gracefully evolve with user actions and viewport size. Site design is concerned with how to provide quick access to important code fragments as well as an entire product with multiple packages, how to balance browser view space between non-trivial text descriptions, code examples, diagrams, and images, and how to provide intuitive navigation through large collections of code and resources. If you wish to provide constructive feedback about this site, visit Website Repository and click on the New discussion tab.

6.0 Other Resources

The Rust community has crafted a number of high quality ebooks and web pages. Here are three that are especially effective.
Rust Cheat Sheet Tour of Rust Rust - The Book
Some parts of this site have broader focus than a single language. Basic Bites introduces simple models for platform, program, and object behaviors. Idioms & Patterns compares small code examples written in C++, Rust, and C#. Tooling helps you get started with language tools so you can start building code quickly. Finally, Software Development deals with the engineering side of project construction.
Basic Bites Tooling for C++, Rust, C# Software Dev: Design Software Dev: UML
There are a lot of programming and language reference materials here. For now, language references focus on C++ and Rust, but eventually the site may add references for C#, and a few other languages. Here are places to look for language support:
Interesting links Check out Interesting Links for technical commentary that relates to things in this site and a few other things I find interesting.
You will find more information about the site goals, design, and status in  SiteDesign.html.
Repository home: https://github.com/JimFawcett
Syracuse University website: https://ecs.syr.edu/faculty/fawcett
Feedback
Your constructive comments and suggestions are welcome. You can provide those here. I'm especially interested in:
  • What you liked and did not like about the site
  • Is site navigation obvious and easy to use?
  • Which of the discussions are too complex or too simple?
  • Are the provided materials: Stories, Bites, Code, .. interesting?
  • Did you find the site attractive
  • Is it easy to use the SiteMap, access Stories and Bites, and use the site widgets (expanding images, badges)?