Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
[IMP] setup/install: improves readability, corrects spelling errors, … #12051
Description of the issue/feature this PR addresses:
This pull request aims to improve upon the structure, readability*, and completeness of the installation guide.
Is Your Business Writing Too Smart for Its Own Good?
How to Write for an Eighth-Grade Reading Level
Current behavior before PR:
Desired behavior after PR is merged:
Flesch Kincaid Grade Level: 9th Grade
I confirm I have signed the CLA and read the PR guidelines at www.odoo.com/submit-pr
@mart-e I don't care for Spiderman either: I don't read comics and I gave my TV away years ago... It's in there because it's about to mention a superficial limitation/drawback.... I feared people might not like hearing about those, given it's in the earliest of stages. I just thought it was a non-technical way of conveying that 'freedom comes with a rope to hang oneself with'/"le corde pour se pendre", which people understand, and I couldn't think of anything else... That being said, if anyone can think of something...
In closing, I know my additions still need heavy editing, but is it something you guys would be willing to work with? I would like to know before I put anymore time into it...
@Yenthe666 Documentation that's enjoyable to read? Whaaat? ;-) Thank you, sir.
@fhe-odoo Would you mind checking these out for me, man, and letting me know if this is something Odoo would be willing to work with? I know it needs further editing, but I've asked others for input on the structural changes, and I haven't heard a peep. I understand some of that—"'everyone' already knows this stuff"—but I would like to finish these up, and move on to more significant improvements.
@yenthe - I'm working on it now and expect I'll have an improved version
On Wed, Jul 27, 2016 at 9:12 AM, Yenthe email@example.com wrote: