On Tue, Jan 9, 2018 at 2:47 AM, Gilles LAMIRAL <[email protected]> wrote:
> The beginning of the tutorial advises to "Spend an hour walking through the > tutorial". Well, it took me 3 hours to just reach half of it and I didn't run > the > "complex" examples Yeah, hmm, well I believe it *did* take 1 hour in the first revision - but it has sort of grown since then :) > I suggest the tutorial could be split in two parts, one basic, really read > and understood in one hour by a beginner, and one advanced containing > everything else, maybe titled as a cookbook. So I have started writing the 'GNU Parallel 2018'-book. The first version I tried doing as you suggest, but it really did not work well for me: Depending on your situation you need to dive deep into one concept without having to know much about the other concepts (e.g. maybe outputting to CSV is key for you, but the rest of the default settings are fine). The concepts hardly overlap, thus it will make perfect sense to be an expert in output-options without knowing more than the basics about remote execution. So instead I have tried dividing the book in parallel: So each section has all information in all details, but the margin has a legend that tells you how advanced the paragraph is. Thus you are encouraged to skip to the next paragraph at your reader level. The book is heavily based on parallel_tutorial. I welcome reader's feedback on it. I have uploaded the current (extremely incomplete) draft at https:://hushfile.it/5a56c3d63d853#nDpLjkqxFB_K3SKjgIm6BBpLuzjOFY_Yfw6mfx0W Open in LibreOffice. Most important feed back would be: Does this marking of the reader level in the margin work? /Ole
