chore: subtree-merge STLShopBook mdbook source (history preserved)
The ShopBook manual source (src/, book.toml, 23 commits of history) now lives under shop-manual-src/. Content migration to Grav pages follows. https://projects.knownelement.com/issues/928
This commit is contained in:
@@ -0,0 +1,2 @@
|
|||||||
|
book
|
||||||
|
.vscode/sftp.json
|
||||||
@@ -0,0 +1,100 @@
|
|||||||
|
# AGENTS.md - Starting Line Productions Shop Book
|
||||||
|
|
||||||
|
This document helps agents understand this codebase and work effectively with it.
|
||||||
|
|
||||||
|
## Project Overview
|
||||||
|
|
||||||
|
This is a **mdBook** project that creates the Starting Line Productions (STL) Shop Guide - a comprehensive manual for a fabrication lab rental business. The project documents tools, equipment, supplies, and procedures across different shop areas (Cleanfab, Dirtyfab, E3ds, Kitchen, HPCLab, RackRental).
|
||||||
|
|
||||||
|
## Essential Commands
|
||||||
|
|
||||||
|
### Building the Book
|
||||||
|
```bash
|
||||||
|
mdbook build # Build the book to `book/` directory
|
||||||
|
mdbook serve # Start live development server (usually on localhost:3000)
|
||||||
|
mdbook clean # Clean build artifacts
|
||||||
|
```
|
||||||
|
|
||||||
|
### PDF Generation (Optional)
|
||||||
|
The `book.toml` contains commented PDF configuration. To generate PDF:
|
||||||
|
1. Uncomment the `[output.pdf]` section in book.toml
|
||||||
|
2. Ensure you have a Chromium-based browser installed
|
||||||
|
3. Run `mdbook build`
|
||||||
|
|
||||||
|
## Code Organization
|
||||||
|
|
||||||
|
```
|
||||||
|
├── src/ # Source markdown files
|
||||||
|
│ ├── SUMMARY.md # Book structure/table of contents
|
||||||
|
│ ├── welcome.md # Introduction page
|
||||||
|
│ ├── version-history.md # Version tracking
|
||||||
|
│ └── [shop-area]-*.md # Content files organized by shop area
|
||||||
|
├── book.toml # mdBook configuration
|
||||||
|
└── SourceMaterialTomerge/ # Binary source files (ODT, PDF, etc.)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Content Structure
|
||||||
|
The book is organized by shop areas:
|
||||||
|
- **Cleanfab**: Clean fabrication shop
|
||||||
|
- **Dirtyfab**: Dirty fabrication shop
|
||||||
|
- **E3ds**: Electronics/3D printing area
|
||||||
|
- **Kitchen**: Kitchen facilities
|
||||||
|
- **HPCLab**: High Performance Computing Lab
|
||||||
|
- **RackRental**: Server rack rental operations
|
||||||
|
|
||||||
|
Each area has:
|
||||||
|
- `*-overview.md`: Area introduction
|
||||||
|
- `*-tools.md`: Available tools
|
||||||
|
- `*-equipment.md`: Equipment inventory
|
||||||
|
- `*-supplies.md`: Supplies list
|
||||||
|
|
||||||
|
## File Naming Conventions
|
||||||
|
|
||||||
|
- Use kebab-case for all filenames
|
||||||
|
- Shop area prefixes: `cleanfab-`, `dirtyfab-`, `e3ds-`, `kitchen-`, `hpclab-`, `rackrental-`
|
||||||
|
- Suffixes indicate content type: `-overview`, `-tools`, `-equipment`, `-supplies`
|
||||||
|
- Standard files: `welcome.md`, `version-history.md`, `SUMMARY.md`
|
||||||
|
|
||||||
|
## Content Patterns
|
||||||
|
|
||||||
|
### Markdown Structure
|
||||||
|
- Use ATX-style headers (`#`, `##`, etc.)
|
||||||
|
- Include links to vendor/product documentation
|
||||||
|
- Add equipment pictures when available (files stored in `SourceMaterialTomerge/`)
|
||||||
|
|
||||||
|
### SUMMARY.md Structure
|
||||||
|
- Must match actual files in `src/` directory
|
||||||
|
- Order: Welcome → Version History → Safety/Security → Area-specific content
|
||||||
|
- Use relative paths: `./filename.md`
|
||||||
|
|
||||||
|
## Important Gotchas
|
||||||
|
|
||||||
|
### Broken Links in SUMMARY.md
|
||||||
|
There's a known issue in SUMMARY.md line 2: `[Version History](./version-history.)` should point to `./version-history.md` (missing `.md` extension).
|
||||||
|
|
||||||
|
### File Extensions
|
||||||
|
Ensure all markdown files in SUMMARY.md have the `.md` extension - mdBook requires exact matches.
|
||||||
|
|
||||||
|
### SourceMaterialTomerge/
|
||||||
|
This directory contains binary files (ODT, PDF, etc.) that are referenced in the content but not directly processed by mdBook.
|
||||||
|
|
||||||
|
## Style Guidelines
|
||||||
|
|
||||||
|
- Write comprehensive, detailed descriptions
|
||||||
|
- Focus on reproducibility - aim for the lab to be fully reproducible by anyone
|
||||||
|
- Include vendor documentation links
|
||||||
|
- Add plenty of images to showcase the shop setup
|
||||||
|
- Maintain consistent structure across shop areas
|
||||||
|
|
||||||
|
## Testing
|
||||||
|
|
||||||
|
After making changes:
|
||||||
|
1. Run `mdbook build` to verify syntax is correct
|
||||||
|
2. Run `mdbook serve` to check the book renders properly
|
||||||
|
3. Check all internal links work in the generated book
|
||||||
|
4. Verify SUMMARY.md entries point to existing files
|
||||||
|
|
||||||
|
## External Resources
|
||||||
|
|
||||||
|
- Project issues: https://projects.knownelement.com/project/reachableceo-vptechnicaloperations/kanban
|
||||||
|
- Discussion: https://community.turnsys.com/g/STLProducrtions
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
# Starting Line Productions Shop guide
|
||||||
|
|
||||||
|
## Repo Description
|
||||||
|
|
||||||
|
We have built a pretty comprehensive network/RF/environmental testing/interop/EE/fabrication lab for Suborbital. It often has idle capacity in between dev cycles. We want to rent that excess capacity (and also provide a franchise revenue sharing arrangement and control plane with other folks who have lab capacity they may want to rent out).
|
||||||
|
|
||||||
|
## Repo Issues
|
||||||
|
|
||||||
|
https://projects.knownelement.com/project/reachableceo-vptechnicaloperations/kanban
|
||||||
|
|
||||||
|
##repo Discussion
|
||||||
|
|
||||||
|
https://community.turnsys.com/g/STLProducrtions
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 133 KiB |
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,46 @@
|
|||||||
|
[book]
|
||||||
|
authors = ["Starting Line Productions LLC"]
|
||||||
|
language = "en"
|
||||||
|
src = "src"
|
||||||
|
title = "Starting Line Productions HQ Franchie Shop Manual"
|
||||||
|
|
||||||
|
[output.html]
|
||||||
|
|
||||||
|
#[output.pdf]
|
||||||
|
## Set for auto-retrying if failed to generate PDF.
|
||||||
|
# trying-times = 1
|
||||||
|
|
||||||
|
## This backend only support latest Chromium based browsers, not Safari and Firefox currently.
|
||||||
|
## If needed, please specify the full path.
|
||||||
|
## If you specify the wrong binary, chances are that there will be a timeout error.
|
||||||
|
# browser-binary-path = ""
|
||||||
|
|
||||||
|
## Assign the static hosting site url so that relative links outside the book can be fixed.
|
||||||
|
#static_site_url = "https://handbook.turnsys.com"
|
||||||
|
|
||||||
|
## Set the theme to be applied for the generated PDF.
|
||||||
|
#theme = "ayu"
|
||||||
|
|
||||||
|
## Check Chrome Devtools Protocol Docs for the explanation of the following params:
|
||||||
|
## https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-printToPDF
|
||||||
|
|
||||||
|
#landscape = false
|
||||||
|
#display-header-footer = true
|
||||||
|
#print-background = true
|
||||||
|
#scale = 0.7
|
||||||
|
#paper-width = 8
|
||||||
|
##paper-height = 10
|
||||||
|
#margin-top = 0.5
|
||||||
|
##margin-bottom = 0.5
|
||||||
|
##margin-left = 0.5
|
||||||
|
##margin-right = 0.5
|
||||||
|
#page-ranges = ""
|
||||||
|
#ignore-invalid-page-ranges = false
|
||||||
|
|
||||||
|
#header-template = "<h3 style='font-size:8px; margin-left: 48%' class='title'></h3>"
|
||||||
|
#footer-template = "<p style='font-size:10px; margin-left: 48%'><span class='pageNumber'></span> / <span class='totalPages'></span></p>"
|
||||||
|
#prefer-css-page-size = true
|
||||||
|
|
||||||
|
#[output.pdf-outline]
|
||||||
|
#like-wkhtmltopdf = false
|
||||||
|
#optional = true
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
- [Welcome](./Welcome.md)
|
||||||
|
- [Version History](./version-history.md)
|
||||||
|
- [Shop Health / Safety / Security information](./shss.md)
|
||||||
|
- [First Aid](./first-aid.md)
|
||||||
|
- [Emergency Action Plan](./emactplan.md)
|
||||||
|
- [Workstation Software (common)](./common-software.md)
|
||||||
|
- [Cleanfab Shop Overview](./cleanfab-shop-overview.md)
|
||||||
|
- [Cleanfab Tools](./cleanfab-tools.md)
|
||||||
|
- [Cleanfab Equipment](./cleanfab-equipment.md)
|
||||||
|
- [Cleanfab Supplies](./cleanfab-supplies.md)
|
||||||
|
- [E3ds shop overview](./e3ds-shop-overview.md)
|
||||||
|
- [E3ds PC Hardware/Software and Peripherals And Equipment](./e3ds-pchwswp.md)
|
||||||
|
- [E3ds Tools](./e3ds-tools.md)
|
||||||
|
- [E3ds Supplies](./e3ds-supplies.md)
|
||||||
|
- [Dirtyfab Shop Overview](./dirtyfab-shopoverview.md)
|
||||||
|
- [Dirtyfab PC Hardware/Software and Peripherals](./dirtyfab-pchwswp.md)
|
||||||
|
- [Dirtyfab Tools](./dirtyfab-tools.md)
|
||||||
|
- [Dirtyfab Equipment](./dirtyfab-equipment.md)
|
||||||
|
- [Dirtyfab Supplies](./dirtyfab-supplies.md)
|
||||||
|
- [Kitchen Overview](./kitchen-overview.md)
|
||||||
|
- [Kitchen Tools](./kitchen-tools.md)
|
||||||
|
- [Kitchen Equipment](./kitchen-equipment.md)
|
||||||
|
- [HPCLab Overview](./hpclab-overview.md)
|
||||||
|
- [HPCLab Inventory](./hpclab-inventory.md)
|
||||||
|
- [RackRental overview](./rackrental-overview.md)
|
||||||
|
- [RackRental inventory](./rackrental-inventory.md)
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Welcome
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Clean Fabrication Shop - Equipment
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Clean Fabrication Shop - Overview
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Clean Fabrication Shop - Supplies
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Clean Fabrication Shop - Tools
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
# Starting Line Productions - General Information - Workstation Software (common)
|
||||||
|
|
||||||
|
We have standarzied the electronic/mechanical/hardware/software engineering and content creation software loadout on all three of the workstations we make available for lease. Each of the workstations also has some function support specific software loaded and that's documented in the appropriate shop section.
|
||||||
|
|
||||||
|
## Software Development
|
||||||
|
|
||||||
|
- Arduino IDE
|
||||||
|
- Anaconda
|
||||||
|
|
||||||
|
## Mechanical Engineering
|
||||||
|
- Elmer
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
# Starting Line Productions - Dirty Fabrication Shop - Equipment
|
||||||
|
|
||||||
|
- Reflow (off the shelf)
|
||||||
|
- Reflow (contello)
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
# Dirtyfab PC Hardware/Software and Peripherals
|
||||||
|
|
||||||
|
- Dell Precision
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
# Dirtyfab Shop Overview
|
||||||
|
|
||||||
|
The STL Dirty Fabrication Shop (dirtyfab) is setup to support a range of functions:
|
||||||
|
|
||||||
|
- Metal work
|
||||||
|
- Wood work
|
||||||
|
- PCB milling/assembly
|
||||||
|
- General fabrication
|
||||||
|
- RF testing
|
||||||
|
- Environmental testing
|
||||||
|
- 3d printing/laser cutting/CNC
|
||||||
|
|
||||||
|
It is located in a converted garage with air conditioning/insulation.
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Dirty Fabrication Shop - Supplies
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
# Dirtyfab Tools
|
||||||
|
|
||||||
|
- Ryobi set
|
||||||
@@ -0,0 +1,28 @@
|
|||||||
|
# E3ds PC Hardware/Software and Peripherals And Equipment
|
||||||
|
|
||||||
|
- [Surface Laptop Go 2](https://www.microsoft.com/en-us/d/surface-laptop-go-2/8pglpv76mjhn?activetab=pivot:overviewtab) with 8gb ram running Windows 11 Professional 22H2
|
||||||
|
- [3d scanner](https://en.openscan.eu/)
|
||||||
|
- [Canon Pixma Pixel Pro 9500 Printer](https://www.usa.canon.com/support/p/pixma-pro9500)
|
||||||
|
- Monoprice Select Mini 3d Printer P/N 15365
|
||||||
|
- Monoprice 3d Printer 2
|
||||||
|
- Go Video VHS/DVD player
|
||||||
|
- 2x USB SATA/IDE connectors
|
||||||
|
- Dazzle
|
||||||
|
- [Fijitsu ScanSnap S1500](https://www.fujitsu.com/us/Images/scansnap-s1500_datasheet.pdf)
|
||||||
|
- Neatdesk Scanner
|
||||||
|
- [Dymo LabelWriter 450 Turbo](https://www.dymo.com/label-makers-printers/labelwriter-label-printers/dymo-labelwriter-450-turbo-direct-thermal-label-printer/SAP_1752265.html)
|
||||||
|
- [Canon Color ImageClass MF734Cdw print/fax/scan](https://www.csai.canon.com/support/p/color-imageclass-mf743cdw)
|
||||||
|
- [Ubiquiti Tough Switch POE](https://dl.ubnt.com/guides/toughswitch/TOUGHSwitch_PoE_8-Port_QSG.pdf) (non PC controlled/connected except when needed)
|
||||||
|
- DC Bench Power Supply (non PC controlled/connected, stand alone unit)
|
||||||
|
- 110 plug
|
||||||
|
- USB power/data hub
|
||||||
|
- [AOYUE Solder Rework Int 899A+ Solder Rework Station](https://www.aoyue3d.com/en/pro/default.asp?id=99)
|
||||||
|
- [ECG J-SSD-1 Solder Station](https://www.dxengineering.com/parts/ecg-j-ssd-1)
|
||||||
|
- [Lumens Document Camera](https://www.mylumens.com/en/Products_detail/41/DC172-Document-Camera)
|
||||||
|
- [Adafruit Microscope](https://www.adafruit.com/product/636)
|
||||||
|
- [Bitscope BS05](http://www.bitscope.com/product/BS05/)
|
||||||
|
- [BusPirate](https://buspirate.com/)
|
||||||
|
- [UT61E Logging Multimeter](https://meters.uni-trend.com/product/ut61-series/)
|
||||||
|
- [ST-Link v2 Jtag](https://www.st.com/en/development-tools/st-link-v2.html)
|
||||||
|
- [Panavise PCB Holder](https://www.panavise.com/index.html?pageID=1&page=full&--eqskudatarq=1)
|
||||||
|
- [Silhouette Cameo 4](https://www.silhouetteamerica.com/featured-product/cameo)
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
# E3ds shop overview
|
||||||
|
|
||||||
|
The E3ds shop is intended to support the following activities:
|
||||||
|
|
||||||
|
- Electronics assembly/repair (non reflow soldering)
|
||||||
|
- Light general repair/assembly/(clean) fabrication work (full set of hand tools)
|
||||||
|
- Vinyl and other light materials (card stock, paper) cutting (computer controlled 2d cutting via Silhouette)
|
||||||
|
- PC/laptop repair and data recovery (multiple external hard drive bays, extensive precision tool collection and non-destructive entry tools)
|
||||||
|
- 3d printing
|
||||||
|
- VHS to digital conversion (via Pixel converter)
|
||||||
|
- Software Development and documentation (Python, Perl, Go, Ruby, R, Node, C/C++, draw.io, modelio etc.) (see comprehensive list below)
|
||||||
|
- General office needs (print/copy/scan/fax, shredding, label making) and also going paperless!
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Electronics And 3d Print Shop - Supplies
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Electronics and 3d Printing Shop Tools
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions Shop Emergency Action Plan
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# Starting Line Productions Shop First Aid
|
||||||
|
|
||||||
|
## Upstairs
|
||||||
|
|
||||||
|
## Downstairs
|
||||||
|
|
||||||
|
|
||||||
|
## Advanced / Specialized Response
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# TSYS High Performance Computing Laboratory Inventory
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
# TSYS High Performance Computing Lab Overview
|
||||||
|
|
||||||
|
Currently, [Turnkey Network Systems LLC](https://turnsys.com/) operates an HPC cluster to run various medium/large engineering workloads. We are considering making some capacity on this cluster available to STLP customers at some point in the future.
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions Kitchen - Equipment
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Kitchen - Overview
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Starting Line Productions - Kitchen - Tools
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# RackRental Inventory
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
# RackRental Overview
|
||||||
|
|
||||||
|
Currently, in internal alpha testing, RackRental will offer a multivendor physical/virtual lab for anything you can imagine regarding networking.
|
||||||
|
|
||||||
|
It's being heavily utilized by TSYS Group in its ongoing R&D efforts to brings a new network hardware/OS stack to market.
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Shop Health / Safety / Security Information
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# Version History
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
# Version history
|
||||||
|
|
||||||
|
v1.0 10/23/2023
|
||||||
|
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
# Starting Line Productions Shop Guide
|
||||||
|
|
||||||
|
Welcome to Starting Line Productions (STLP)!
|
||||||
|
|
||||||
|
We created STLP to serve the needs of our parent corporation, [Turnkey Network Systems LLC](https://turnsys.com/), and support R&D at Suborbital Systems (high altitude balloons) and MeetMorse (ground stations and subscriber equipment). We have spare capacity in between hardware revisions and wanted to monetize the asset base. Hence, we are making it available to the public at industry leading breakthrough pricing and access hours.
|
||||||
|
|
||||||
|
This document provides a comprehensive overview of the tools, equipment and supplies provided as part of your rental. It covers all the rental areas, what is provided with each and
|
||||||
|
links to vendor/product documentation. A big goal of STLP is to have the lab be fully reproducible by anyone!
|
||||||
|
|
||||||
|
We include pictures of all the areas and tools/equipment. We put quite a bit of work into building this shop and want to show it off!
|
||||||
|
|
||||||
|
Furthermore, this manual is intended to be comprehensive and cover everything you may need to know!
|
||||||
Reference in New Issue
Block a user