On Sun, Feb 14, 2016 at 4:50 AM, John Wiegley <[email protected]> wrote:
> >>>>> Martin Blais <[email protected]> writes: > > > You can write the text in Emacs and import it later on when you > reconnect if > > you're stuck on a flight or a train, as John mentions (how often does > that > > happen anyway?). > > "How often does that happen anyway?" Often. What's comfortable for your use > case is not the same as what everyone else is doing or experiencing. > > I prefer to have docs maintained under Git, offline accessible, in an open > format that Emacs is able to edit. That could be Markdown, LaTeX, TeXinfo, > or > any of the other free formats available. I can't think of even one > advantage > Google Docs has to offer me, given the way I work on software projects: > It's > not offline accessible, it uses its own UI, it puts me in the browser for > editing, and I can't use Git to examine history. I might as well be > editing a > Microsoft Word document in a network mounted folder, as work sometimes > makes > me do. > The comments you make in this paragraph are all about _your_ experience, as the author of the text. Did you even read my message? (The part where I'm reframing R. Hickey's argument from "Simple made easy"?) And all for what, because you say it will attract more contributors to the > documentation effort? I wouldn't take it on your word against those > negatives, > while also losing the positives (for me) of the Markdown/Texinfo approach. > Not "will", but "has". I'm not reporting a hypothetical from the future, I'm reporting actual, lived experience from the past. Witness it for yourself: Access any of my docs (e.g. http://furius.ca/beancount/doc/syntax) and click on the "Comments" button on the top-right to view a full history of accepted and rejected suggestions and their accompanying micro-threads, you'll see the activity there. Check it out, don't trust me. On the whole set of documents I get suggestions and fixes _every single day_. Don't you wish you had that level of interaction with your users? -- --- You received this message because you are subscribed to the Google Groups "Ledger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
