[docs]PDF manual stub - Githubissues

sokoow / globalhack-laptop-installer

Globalhack entry - easy laptop automated imager

https://devpost.com/software/help-education-sector-to-produce-more-laptops-for-students#updates

MIT License

5 stars 2 forks source link

[docs]PDF manual stub #6

Open sokoow opened 4 years ago

sokoow commented 4 years ago

We'll need a simple, maybe even image/based manual for the whole lot. General assumptions:

user downloads a small-ish USB/ISO
then they burn the ISO on USB using something like https://www.balena.io/etcher/
then they need to connect an ethernet cable to their laptop from their home router (sorry, no easy way to do this through wifi)
then they boot into ISO/USB, select 'install/image my laptop'
wait for 45 minutes-ish
reboot and remove USB key, voila!

sokoow commented 4 years ago

Here's how I see this being done:

grab a spare laptop or Virtualbox
Follow https://github.com/sokoow/globalhack-laptop-installer/blob/master/README.md , section How do I test this?
make screenshots or pictures of screens with your phone for the whole process
upload these pictures to this repo
make a skeleton of a manual

sokoow commented 4 years ago

if someone can record a youtube video, that would be cool also

LupusE commented 4 years ago

I've tried to write one ... My Windows Laptop is at work, so I'll try to add some Screenshots tomorrow. SokoowOne-HowTo_start.pdf

sokoow commented 4 years ago

@LupusE thanks so much ;) well done

LupusE commented 4 years ago

Improved somehow. The Etcher isntallation is quite simple and need no more screenshots. Everything else is from a Virtualbox installation. Somewhere I'd like to recommend a SSD as installation target. Next Step is to convert the text into LaTeX, to make it more easy to host on Github. Right now I've just wanted to create a quick draft to discuss the content. All text and Images are free to use, also for other places on the project (Homepage, Wiki, ...). If you have to improve something, please set it back into the source, so we can create a consistent knowledge base. SokoowOne-HowTo_start.pdf ... I can't upload the source .odt here, but it is available at request.

LupusE commented 4 years ago

I've tried to learn LaTeX ... It does take a while. I've also tried Scribus, because it will store in an easily editable format. but this solution isn't useful here on multiple ages with bullitpoints.

Where can I upload the .pdf and the source .odt? I would say \docs\ is the right place, but here is the website. Should I create \docs\manual\ or a whole different root?