vegadeftwing / opguideshugosrc

Repo for the development of OpGuides

Vega is the brightest star in the northern constellation of Lyra. It has the Bayer designation α Lyrae.

Primary maintainer of Opinionated Guides

RFID chipped, modular synthesis nerd, often found programming guitars and playing computers. I strum Dvorak, and type in chords. I'm the guy with a vacuum tube around his neck.

---

Find me elsewhere on this series of tubes:

Twitter , [email protected]

If you like what I do - be it OpGuides, making VCV modules, or doing shader dev, consider supporting me on Github Sponsors, using the link on this page

---

LINUX/BSD • Arch Linux used daily for both personal compute needs as well as for servers for over a decade • Very familiar with the internal workings of Linux and how to maintain a system for security and longevity, as well as how to diagnose problems that may stem from operating system level issues • Extensive BSD and ZFS experience in both personal and business contexts • Experience tweaking systems for low latency and high throughput • Comfortable working strictly from a terminal

Electronics • Varying levels of familiarity with most popular embedded product lines (STM32, ATMEGA, ESP32/8266) as well as work on FPGAs from various manufactures • Diagnosed and repaired many digital and analog electronics • Experience developing printed circuit boards using KiCad • Comfortable with hand soldering and prototype design • Familiar with audio electronics (synthesizers, amplifiers, etc.)

Programming • Comfortable writing and debugging C and C++ • Experience writing and debugging python(2/3) • Experience making complex shell scripts to rapidly solve problems • General familiarity with many other languages • Varying familiarity with assembly on many platforms • Work with GpGPU programming, primarily in Python

Networking • Experience setting up, managing, and testing large, complex networks with multiple VLANs • Licensed amateur radio operator (KE0WGV), experience with Software Defined Radio platforms

Security • Secured many networks and tested many networks for security problems • Found an access control bypass in a network based on trusting user supplied data, responsibly disclosed • Factory RFID tagged in both hands for your access control convenience • Managed firewall rules and DNS blackhole systems

---

Projects & Nerby Hobbies

• High voltage burning, making lichtenberg figures in both wood and animal bone • Modification of synthesizers and guitar pedals • Making generative music in various visual auido programming enivronments (VCV, Pure Data, ORCΛ) • Making modules for said visual audio programming environments • Working with mechanical keyboards, espically those running QMK • Retro tech - I have a C64, core memory, and a whole lot of tube amps • Some 3D printing, but I'm more into pen-plotting & lasers for making 2D generative art physical • VR - Including some 3D modeling, texturing, and shader development for VRChat • Delidding old ICs, Finding Trends in Assembly Instructions

opguideshugosrc's Issues

Topography Fix

Some of the titles, espically as headings get smaller, are sized super awkwardly. This could use some help

Add compilers section

@jhwgh1968, I'm making this issue so that I don't forget about this.

Docker and Virtualization chapter or section?

Oi, I know a thing or two about docker and how you can use it to run services and create static dev environments. I can bestow a bit of knowledge if wanted.

Remove all Twitter Embeds

I did a count across all pages and found 79 Twitter embeds that should be replaced with screenshots of the tweet or local hosting of the videos/pictures. This is a bit uncomfortable from a fair use perspective, but as it's for archival sake given the state of Twitter I'm making the call to switch them all over.

Add links showing off the shelf NAS boxes may have poor security

    Really well written as always. I'll add a tiny bit to this later, as I want to make sure to mention the various data-destroying hacks such as https://arstechnica.com/information-technology/2022/09/new-wave-of-data-destroying-ransomware-attacks-hits-qnap-nas-devices/ and https://arstechnica.com/gadgets/2021/06/mass-data-wipe-in-my-book-devices-prompts-warning-from-western-digital/ to dissuade a bit from the ready to go solutions. Thank you!

Originally posted by @VegaDeftwing in #35 (comment)

Header images on every page?

I wouldn't mind adding some visual flair to the guide. There's some really long walls of text, and while I may not be able to totally break them up, I think adding at least one image to the top of every page, ideally with a common style would be good. I might do some sort of very low-bit monochome dithered image like on https://solar.lowtechmagazine.com to avoid adding a ton of data to the site, though I'm not sure that would really fit the theme of the site as is.

The other option would be to commission a TON of furry art, like Soatok's site, but I'm not sure that's entirely the vibe I want to go for.

Fix alignment of section headings, probably with CSS

@docquantum you said you might be able to help

All images to .webp

I'd like to get the static folder cleaned up and sorted into folders of 'ByVega' 'Unsplash' 'Wikipedia' 'Fair Use' plus some page specific folders, most notably one for the generative art page since it loads so many images.

I'm making this an issue in case any one has an objection to the .webp-ification of all the images.

Page Status (Done Enough)

Engineering

Introduction

• 0 What is this?
• Ⅰ Community
• Ⅱ Learn How to Learn

Linux & Your Computer

• 1 The First Goal
• 2 Installing Arch Linux arch's installation procedure has changed a tad from when I wrote this, so this basically just needs someone to follow along and check that there's no incorrect/missing steps
• 3 Into The Hardware
  • 3.1 CPU
  • 3.2 RAM Still needs work on "Virtual Memory & Swap"
  • 3.3 Motherboard
  • 3.4 Graphics Still needs "Hardware Acceleration" and a new picture
  • 3.5 Storage Still needs RAID & ZFS
  • 3.6 Networking
  • 3.7 Power Still needs power management (performance profiles)
  • 3.8 Cooling
  • 3.9 Peripherals
  • 3.10 The Bigger Picture
  • 3.11 What to Buy?
  • 3.12 Legacy
• 3½Architectures
• 4 Getting Rooted in Linux
• 5 Working on How we work
• 5½Git
• A1 Using The Linux Shell Still needs descriptions and links to the lists of programs

Prerequisites

• 6 Math
  • 6.1 Algebra
  • 6.2 Logic Combine with Chapter 24?
  • 6.3 Geometry & Trig
  • 6.4 Calculus
  • 6.5 Diff Eq
  • 6.6 Linear Algebra
  • 6.7 Numerical Analysis
  • 6.8 Set Theory
  • 6.9 Probability 6½
• 6½Units
• 7 Physics
• 8 Chemistry
• 9 'The Rest'

Programming

• 10 Let's Write Some Code
• 10½Consequences
• 11 Low Level Programming
• 11½FOSS & Copyright (In progress, Thanks @jhwgh1968 !)
• 12 Yet More Programming
• 12½Fixing Issues
• 13 Programming Languages
• 14 Algorithms and More
• 15 Writing a Big Program
• 16 Debugging, CI & CD
• 17 We've Got Cores!
• 18 Graphical Programming
• 19 Game Programming
• 20 (((())(()((()(()))))))
• 21 Fine, here's AI/ML Notes from class have largely been put in, but it really needs help

Circuits

• 22 Circuits!
• 23 Semiconductors
• 23½Parts
• 24 Digital Logic
• 25 Embedded Systems
• 26 Let's Make our own PCB

Signal Processing

• 27 Signals & Systems
• 28 Communications
• 29 DSP
• 30 Control Systems

Going Deeper

• 31 Compilers & Assemblers
• 32 Reverse Engineering
• 33 Programmable Logic
• 34 Let's Make our own CPU

Networking & Servers

• 35 Networking
• 36 Servers!
• 36½"The Cloud"
• 37 Databases
• 38 Security & Exploitation page is actually pretty far along, "Types of exploits" is very bare though
• 38½Privacy

Making and Hobbies

• 39 3D Printing & CNC
• 40 Ham Radio
• 41 Computer History

Wrapping Up

• 42 Where next?
• A2 Cheat Sheets & Libraries
• A3 Other Great Resources
• A4 Getting a Job
• A5 Markdown and LaTeX

Music

• 1 Getting Started
• 2 Sound Sources Largely done, needs some of the more esoteric sources explained
• 3 Instruments
  • 3.1 Percussion not done, but the drums are largely done enough. Lacks anything but drums rn
  • 3.2 Strings
  • 3.3 Wind
  • 3.4 Synths
  • 3.5 The Esoteric
• 4 Effects still needs "What order should my effects be in?"
  • 4.1 Trivial Effects
  • 4.2 Time Based Effects still needs descriptions of different reverbs
  • 4.3 Filters!
  • 4.4 Dʸⁿᵃᵐᶦᶜˢ Pretty close! Just needs brought over the finish line
  • 4.5 Everything Else needs de-noise, de-ess, and ring mod
• 5 Sequencing & MIDI
• 6 Software
  • 6.1 DAW?
  • 6.2 Plugins!
  • 6.3 Live Code table needs converted to cols- see Design:Generative Tools
• 6½MIDI in Detail still needs "MIDI Routing Hardware"
• 7 Hardware needs details about specific hardware, but general stuff is largely done
• 8 Theory
• 9 Mixing & Mastering
• A1 Other Resources
• A2 Video
• A3 VCV Tips

Philosophy

• 1 Basic Philosophy needs basic phil ideas beyond Utilitarianism
• 2 Logical Fallacies+ largely from wikipedia, edges on fair use
• 3 Arguments
• 4 Community Idea Labs
• 5 Community Efforts
• 6 Education
• 7 Labor & Compensation
• 8 Copyright
• 9 Consumerism page is very far along, but needs another push
• 10 Law & Order
• 11 Infrasturcture
• 12 Environment
• 13 Religion
• 14 Sex
• 15 Medical
• 16 Foriegn Involvement
• 17 Voting
• 18 Freedoms & Rights
• 19 Duties
• 20 Internet page shouldn't be bad to finish up, largely done and has links to things not yet written about
• 21 Misc
• A1 Other Resources

Design

• 1 Basics of Art
• 2 Analog Art
• 3 Digital Art
• 4 UI/UX
• 5 3D
• 6 Generative Tools need to add a new section for all the tools that are commented out of the live page
• A1 Other Resources
• A2 Inspirational Art
• A3 Photo

Interviews

N/A

Other

• Cool Hardware
• The Way We Interact With Computers Sucks Almost done, mostly needs chapter 3 and 5 fleshed out

Rational numbers are partial missing, I think?

See https://github.com/VegaDeftwing/OpGuidesHugoSrc/blob/main/content/Engineering/Math/algebra.md
At Integers where right after the tip section it somehow goes into rational numbers?

I'm not sure if this is supposed to be like that, but it seems wrong?

Copyright Policy?

I am quite impressed with this guide, and would like to contribute! However, I am reluctant to, because I see no clarity on the copyright in the only paragraph of words about it.

Even as a non-lawyer, I would like the README to answer the following unanswered questions:

1. When a contributor opens a PR, what do they agree to?
2. Who owns the copyright on the text? Lots of contributors on their individual contributions, certain people on certain sections, or is everything given to @VegaDeftwing?
3. Can contributors license it under different, non-conflicting terms that the copyright text?
4. Are there limitations on what can be contributed by others? For example, The Rust Book refuses to accept large changes from contributors in order to limit their copyright liability. (It is printed by a real book publisher with only the principle authors listed by name. Something mentioned in the copyright text as possible in the future.)
5. What attestation and/or process is required to avoid copyright infringement/plagarism?

While I would personally suggest replacing your current copyright text with a Creative Commons License (several of the flavors are very close to what you're trying to do, and they have been reviewed by actual lawyers) getting these questions answered is most important to me.

Either way, it is fortunate the the number of contributors is small at this point in time. That means very few people would have to agree to any changes/rules.

If it would help, I can open a PR with boilerplate once I get some basic answers.

(P.S. You know where I was going to contribute? The "licensing" section. 😄)

Ideas and links

I'm not currently at my own computer, but have some links & ideas to add myself:

• https://therealadam.com/2021/11/01/dont-be-spooky/ -> The english section of "The Rest"
  • 033e549
• Split up "The Rest
• Something on quantum computing and the recent nobel prize
• I'd like to clean up the AI chapter and spit it in two, with the first page just being a "What's possible" that eases into how it works from a high level. I'd also like to focus on being practical and doing things people actually want to do, like fine-tuning Stable Diffusion, making text generators, doing natural language processing, etc.
• I want to redo some of the git stuff to focus on having a GUI. If someone wants to go full command only, sure, but it's not reasonable to teach.
• Unit testing. I really, really need unit testing advice for programmers.
• The VST list still needs completed.
• The effects list needs a way to display all the DSP comments.
• The Design web dev header appears to be broken and the chapters duplicated.
  • Menu broken in 423a9f9, fixed in 038b8b8
• The math chapters need some love. I need to figure out how to get animations on them.
• When making the programming chapters use Zig, setup the Zig Language Server for VSCode

Create Icons for lists

From https://rosano.hmm.garden/01ev1y7rmjztmqdshtvkv714wy

This seems like an overall good idea. I might need to commision an artist though If I can't do it myself.

Archival & Access over the long term

I'm not sure to what extent links and embed content on OpGuides will stay up. Further, some websites (Twitter, Instagram) are requiring login to view content. Hosting a screenshot is an option, though poses more significant copyright concern. A happy middle ground is needed.

Non embedded content (links) could all probably be set to redirect to the Internet Archive. This seems like the most practical way to maintain access short of keeping everything local and serving via torrent (necessary as some content, namely videos, are especially large). Again, this poses real copyright questions but should be protected-ish as it is for archival purposes.

I am very open to alternative ideas