owners: apologies if this isn't the correct place. i can't seem to find the source of all of the assembly guides for all revisions. Just the PDFs here in this repo, and other repos.
Hello! The assembly manuals are awesome. Love the font, scheme, clearness, etc.
As I have purchased/sourced my parts for my 2.4 build, and starting to dig deep into Voron User mods, many many live streams of assembly (Tom, Nero 3dp, etc), and reading 1000s of chats, there seems to be a common theme that I haven't seen addressed yet. I can sum it up by repeating what I saw Nero 3DP enter into the chat multiple times over Tom's live streams of his 8 part series (oh yeah, I watched all 24 hours of it!!), along with other dev members/community members...
The manual needs to be updated.
(and) There's a running list.
Therefore, I would like to propose a different approach to these Assembly Manuals:
Place the source of the manuals online, and generate them from source (e.g. LaTeX) to iterate on them much faster. Also, tracking changes and allowing members to submit PRs in a central place.
I know the chaos this sounds like: opening up the precious documents to possibly 1000s of people thinking this or that needs to be changed. But, hear me out...
- I have had to start my own "things that need to be updated" list, order extra parts because X said Y in the live streams and not sure if I need to do that or not, because I can't find that "There's a running list" online anywhere.
- Having the "running list" online would be a great place for new builders to come in and say, "Ah, I should follow this Page 48 in the updated list and not the guide."
- Community members would see/experience issues with the assembly manuals, and propose the changes in a central place.
That last one is key: a central place to expose the current source of the assembly manuals, along with upcoming changes to those manuals.
It would help iterate the manual revisions much faster. Merge PR into master/main, manual gets rebuilt, pushed out to the appropriate repo automatically - daily.
If that "running list" are the Issues in this repo, then it looks like we are missing the online source piece. And it would default to someone still having to read the issue, verify the change, confirm it works, update the docs (wait for other changes), and then release a new one.